Technical  Report  CHL-98-15 
June  1998 


US  Army  Corps 
of  Engineers 

Waterways  Experiment 
Station 


A  Numerical  Model  Simulating  Flow, 
Contaminant,  and  Sediment  Transport 
in  Watershed  Systems  (WASH12D) 

by  Gour-Tsyh  Yeh,  Hwai-Ping  Cheng,  Jing-Ru  Cheng, 
Pennsylvania  State  University 

Hsin-Chi  J.  Lin,  WES 


Approved  For  Public  Release;  Distribution  Is  Unlimited 


19980810  137 

"jyjxc  QUAirry  h^spected  i 

Prepared  for  U.S.  Environmental  Protection  Agency 


The  contents  of  this  report  are  not  to  be  used  for  advertising, 
publication,  or  promotional  purposes.  Citation  of  trade  names 
does  not  constitute  an  official  endorsement  or  approval  of  the  use 
of  such  commercial  products. 

The  findings  of  this  report  are  not  to  be  construed  as  an 
official  Department  of  the  Army  position,  unless  so  desig¬ 
nated  by  other  authorized  documents. 


PRINTED  ON  RECYCLED  PAPER 


Technical  Report  CHL-98-15 
June  1998 


A  Numerical  Model  Simulating  Flow, 
Contaminant,  and  Sediment  Transport 
in  Watershed  Systems  (WASH12D) 

by  Gour-Tsyh  Yeh,  Hwai-Ping  Cheng,  Jlng>Ru  Cheng 

Department  of  Civil  and  Environmental  Engineering 
Pennsylvania  State  University 
University  Park,  PA  16802 

Hsin-Chi  J.  Lin 

U.S.  Army  Corps  of  Engineers 
Watenways  Experiment  Station 
3909  Halls  Ferry  Road 
Vicksburg,  MS  39180-6199 


Rnal  report 

Approved  for  public  release;  distribution  is  unlimited 


Prepared  for  Athens  Ecosystems  Research  Division 
Office  of  Research  and  Development 
U.S.  Environmental  Protection  Agency 
Athens,  GA  30605-2700 


Waterways  Experiment  Station  Cataloging-in-Publication  Data 

A  numerical  model  simulating  flow,  contaminant,  and  sediment  transport  in  watershed  systems 
(WASH12D)  /  by  Gour-Tsyh  Yeh ...  [et  ai.] ;  prepared  for  Athens  Ecosystems  Research  Division,  Office 
of  Research  and  Development,  U.S.  Environmental  Protection  Agency. 

209  p. :  ill. ;  28  cm.  —  (Technical  report ;  CHL-98-15) 

Includes  bibliographic  references. 

1.  Watersheds  —  Mathematical  models.  2.  Contaminated  sediments  —  Mathematical  models.  3. 
Sediment  transport  —  Mathematical  models.  4.  WASH12D  (Computer  program)  I.  Yeh,  Gour-Tsyh.  II. 
United  States.  Army.  Corps  of  Engineers.  III.  U.S.  Army  Engineer  Waterways  Experiment  Station.  IV. 
Coastal  and  Hydraulics  Laboratory  (U.S.  Army  Engineer  Waterways  Experiment  Station)  V.  United  States. 
Environmental  Protection  Agency.  Office  of  Research  and  Development.  Athens  Ecosystems  Research 
Division.  VI.  Series:  Technical  report  (U.S.  Army  Engineer  Watenways  Experiment  Station) ;  CHL-98-15. 
TA7W34no.CHL-98-15 


TABLE  OF  CONTENTS 


PREFACE  ix 

SUMMARY  X 

1.  INTRODUCTION  Secl-1 

2.  MATHEMATICAL  BASIS  Sec2-1 

2.1.  Water  flow  in  1-D  river/stream  network  Sec2-1 

2.2.  Water  flow  in  2-D  overland  Sec2-2 

2.3.  Contaminant  and  sediment  transport  in  1-D  river/stream  network  Sec2-5 

2.4.  Contaminant  and  sediment  transport  in  2-D  overland  Sec2-9 

3.  NUMERICAL  APPROACHES  Sec3-1 

3.1.  Solving  the  1-D  liver/stream  flow  equations  Sec3-1 

3.1.1.  Method  of  characteristics  for  1-D  dynamic  wave  model  Sec3-1 

3.1.2.  The  Lagrangian  ^proach  for  both  1-D  diffusion  and  1-D  kinematic  wave  models  Sec3-9 

3.1.3.  Conqtutation  of  water  budget  at  junctions  Sec3-10 

3.2.  Solving  the  2-D  overland  flow  equations  Sec3-1 1 

3.2.1.  Method  of  characteristics  for  2-D  dynamic  wave  model  Sec3- 1 1 

3.2.2.  The  Lagrangian  approach  for  both  2-D  diffusion  and  2-D  kinematic  wave  models  Sec3-23 

3.3.  Solving  the  1-D  river/stream  transport  equations  Sec3-25 

3.3.1.  Procedures  of  solving  1-D  river/stream  transport  equations  Sec3-26 

3.3.2.  Determining  contaminant  and  sediment  concentrations  at  junctions  Sec3-31 

3.3.3.  Estimation  of  Eteposition  and  Erosion  Sec3-33 

3.4.  Solving  the  2-D  overland  transport  equations  Sec3-34 

4.  EXAMPLES  Sec4-1 

4.1.  Examples  of  1-D  river/stream  flow  Sec4-1 

4.1.1.  Example  1  of  1-D  river/stream  flow  Sec4-1 

4.1.2.  Exanq)le  2  of  1-D  liver/stream  flow  Sec4-2 

4.2.  Exanqiles  of  2-D  overland  flow  Sec4-5 

4.2.1.  Example  1  of  2-D  overland  flow  Sec4-5 

4.2.2.  Exauqjle  2  of  2-D  overland  flow  Sec4-8 

4.3.  Exaiiq)le  of  1-D  river/stream  transport  Sec4-ll 

4.4.  Example  of  2-D  overland  transport  Sec4-18 

4.5.  Exan5>le  of  1-D  xiver/stream  flow  and  transport  Sec4-20 

4.6.  Exanqjle  of  2-D  overland  flow  and  transport  Sec4-24 

4.7.  Exair^le  of  1-D/2-D  flow  Sec4-32 

4.8.  Example  of  1-D/2-D  flow  and  transport  Sec4-37 

5.  SUMMARY  AND  CONTINUING  WORKS  Sec5-1 


iii 


REFERENCES 


REF-1 


Appendix  A:  DATA  INPUT  GUIDE  ^pA-1 

2-D  overland  geometry  file  (.2dm  files  for  2-D  overland  simulations)  AppA-1 

2-D  overland  flow  file  (.2bc  files  for  2-D  overland  simulations)  AppA-1 

2-D  overland  transport  files  (.2tp  files  for  2-D  overland  simulations)  AppA-10 

1-D  liver/stream  geometry  file(.2dm  files  for  1-D  river/stream  simulations)  AppA-17 

1-D  river/stream  flow  file  (.2bc  files  for  1-D  river/stream  simulations)  AppA-17 

1-D  rivCT/stream  transport  file  (.2tp  files  for  2-D  overland  simulations)  AppA-27 

1-D/2-D  contaminant/sediment  file  (.2ch  files  for  transport  simulations)  AppA-33 

1-D/2-D  mapping  file  (.map  files)  AppA-36 

Appendix  B:  PROGRAM  STRUCTURE  AND  SUBROUTINE  DESCRIPTION  AppB-1 

Program  Structure  AppB-1 

Subroutine  Description  AppB-12 

Appendix  C:  PARAMETERS  FOR  RUNNING  THE  COMPUTER  CODE  AppC-I 


SF298 


rv 


TABLE  OF  FIGURES 


Figure  3.1.  Tracking  along  characteristics  in  solving  1-D  dynamic  wave  equation.  Sec3-5 

Figure  3.2.  Tracking  along  characteristics  in  solving  2-D  dynamic  wave  equation.  Sec3-18 

Figure  4.1.  The  bottom  elevation  of  Examftle  1  of  1-D  river/stream  flow.  Sec4-1 

Figure  4.2.  Water  depth  at  various  times  for  Exanqjle  1  of  1-D  river/stream  flow.  Sec4-2 

Figme  4.3.  Discharge  at  various  tunes  for  Example  1  of  1-D  liver/stream  flow.  Sec4-2 

Figure  4.4.  River/stream  network  for  Example  2  of  1-D  river/stream  flow.  Sec4-3 

Figure  4.5.  Water  depth  of  Reach  1  at  various  times  for  Exanq)le  2  of  1-D  river/stream 

flow.  Sec4-4 

Figure  4.6.  Water  depth  of  Reach  2  at  various  times  for  Exan:q)le  2  of  1-D  river/stream 

flow.  Sec4-4 

Figure  4.7.  Water  depth  of  Reach  3  at  various  times  for  Exan:^>le  2  of  1-D  river/stream 

flow.  Sec4-4 

Figure  4.8.  The  contour  of  bottom  elevation  for  Exanq}le  1  of  2-D  overland  flow.  Sec4-6 

Figure  4.9.  Discretization  for  Example  1  of  2-D  overland  flow.  Sec4-6 

Figqre  4. 10.  Water  depth  at  various  times  for  Exanq)le  1  of  2-D  overland  flow.  Sec4-7 

Figure  4. 1 1.  Comparison  of  water  depth  between  analytical  solutions  and  numerical  results 

for  Exan:q)le  2  of  2-D  overland  flow.  Sec4-9 

Figure  4.12.  Conqjarison  of  velocity  between  analytical  solutions  and  numerical  results 

for  Example  2  of  2-D  overland  flow.  Sec4-10 

Figure  4.13.  Concentrations  of  (a)  the  first,  (b)  the  second,  and  (c)  the  third  dissolved 

chemicals  for  the  example  of  1-D  river/stream  transport  Sec4-13 

Figure  4.14.  Concentrations  of  (a)  the  first,  (b)  the  second,  and  (c)  the  third  suspended 

sediments  for  the  example  of  1-D  liver/stream  transport  Sec4- 14 

Figure  4.15.  Concentrations  of  (a)  the  first,  (b)  the  second,  and  (c)  the  third  bed 

sediments  for  the  exanqjle  of  1-D  river/stream  transport  Sec4-15 

Figure  4.16.  Concentrations  of  the  first  particulate  chemical  on  (a)  the  first,  (b)  the  second, 
and  (c)  the  third  suspended  sediments  for  the  example  of  1-D  river/stream 
transport  Sec4-16 


V 


Sec4-17 


Figure  4.17.  Concentrations  of  the  first  particulate  chemical  on  (a)  the  first,  (b)  the  second, 
and  (c)  the  third  bed  sediments  for  the  exanq}le  of  1-D  river/stream 
transport 


Figure  4.18.  Concentration  contour  of  the  first  dissolved  chemical  at  time  =  260  s  for  the 

exanple  of  2-D  overland  transport  Sec4- 1 8 

Figure  4.19.  Concentration  contour  of  the  second  dissolved  chemical  at  time  =  260  s  for  the 

exaiiq>le  of  2-D  ova-land  transport  Sec4-19 

Figure  4.20.  Concentration  contour  of  the  third  dissolved  chemical  at  time  =  260  s  for  the 

example  of  2-D  overland  transport  Sec4-19 

Figure  4.21.  Concentration  contour  of  the  fourth  dissolved  chemical  at  time  =  260  s  for  the 

exanq)le  of  2-D  overland  transport  Sec4- 1 9 

Figure  4.22.  Concentration  contour  of  the  fifth  dissolved  chemical  at  time  =  260  s  for  the 

example  of  2-D  overland  transport  Sec4-20 

Figure  4.23.  Concentration  contour  of  the  sixth  dissolved  chemical  at  time  =  260  s  for  the 

exanqjle  of  2-D  overland  transport  Sec4-20 

Figure  4.24.  Water  depth  at  various  times  for  the  example  of  1-D  liver/stream 

flow  and  transport  Sec4-21 

Figure  4.25.  Concentration  of  the  first  dissolved  chemical  at  various  times  for  the  exan[q>le 

of  1-D  river/stream  flow  and  transport  Sec4-22 

Figure  4.26.  Concentration  of  the  second  dissolved  chemical  at  various  times  for  the  exaiiq)le 

of  1-D  river/stream  flow  and  transport  Sec4-22 

Figure  4.27.  Concentration  of  the  third  dissolved  chemical  at  various  times  for  the  exair^le 

of  1-D  river/stream  flow  and  transport  Sec4-22 

Figure  4.28.  Concentration  of  the  fourth  dissolved  chemical  at  various  times  for  the  example 

of  1-D  river/stream  flow  and  transport  Sec4-23 

Figure  4.29.  Concentration  of  the  fifth  dissolved  chemical  at  various  times  for  the  exan5)le 

of  1-D  river/stream  flow  and  transport  Sec4-23 

Figure  4.30.  Concentration  of  the  sixth  dissolved  chemical  at  various  times  for  the  exaiiq)le 

of  1  -D  river/stream  flow  and  transport  Sec4-23 

Figure  4.31.  Water  depth  at  various  times  for  the  example  of  2-D  overland  flow  and 

transport  Sec4-25 

Figure  4.32.  Concentration  of  the  first  dissolved  chemical  at  various  times  for  the  exanq}le 

of  2-D  overland  flow  and  transport  Sec4-26 


VI 


Figure  4.33.  Concentration  of  the  second  dissolved  chemical  at  various  times  for  the  example 

of  2-D  overland  flow  and  transport  Sec4-27 

Figure  4.34.  Concentration  of  the  third  dissolved  chemical  at  various  times  for  the  exan:Q)le 

of  2-D  overland  flow  and  transport  Sec4-28 

Figure  4.35.  Concentration  of  the  fourth  dissolved  chemical  at  various  times  for  the  example 

of  2-D  overland  flow  and  transport  Sec4-29 

Figure  4.36.  Concentration  of  the  fifth  dissolved  chemical  at  various  times  for  flie  exanq>le 

of  2-D  overland  flow  and  transport  Sec4-30 

Figure  4.37.  Concentration  of  the  sixth  dissolved  chemical  at  various  times  for  the  example 

of  2-D  overland  flow  and  transport  Sec4-3 1 

Figure  4.38.  The  topography  and  grids  for  the  exanple  of  1-D/2-D  flow.  Sec4-33 

Figure  4.39.  Water  depth  of  1-D  river/stream  at  various  times  for  the  exan:q)le  of 

1-D/2-D  flow.  Sec4-34 

Figure  4.40.  Velocity  of  1-D  river/stream  at  various  times  for  the  example  of 

1-D/2-D  flow.  Sec4-35 

Figure  4.41.  Water  depth  of  2-D  overland  at  various  times  for  the  example  of  1-D/2-D  flow.  Sec4-36 


Figure  4.42.  The  topogr^hy  and  grids  for  the  exanple  of  1-D/2-D  flow 

and  transport  Sec4-39 

Figure  4.43.  Water  depth  of  1-D  river/stream  at  various  times  for  the  exanple  of 

1-D/2-D  flow  and  transport  Sec4-40 

Figure  4.44.  Water  depth  contour  of  2-D  overland  at  various  times  for  the  exanple 

of  1-D/2-D  flow  and  transport  Sec4-41 

Figure  4.45.  Concentration  of  the  first  dissolved  chemical  in  1-D  river/stream 

at  various  times  for  the  exanple  of  1-D/2-D  flow  and  transport  Sec4-42 

Figure  4.46.  Concentration  of  the  second  dissolved  chemical  in  1-D  river/stream 

at  various  times  for  the  exanple  of  1-D/2-D  flow  and  transport  Sec4-43 

Figure  4.47.  Concentration  of  the  third  dissolved  chemical  in  1-D  river/stream 

at  various  times  for  the  example  of  1-D/2-D  flow  and  transport  Sec4-44 

Figure  4.48.  Concentration  of  the  foxulh  dissolved  chemical  in  1-D  river/stream 

at  various  times  for  the  exanple  of  1-D/2-D  flow  and  transport  Sec4-45 

Figure  4.49.  Concentration  of  the  fifth  dissolved  chemical  in  1-D  river/stream 

at  various  times  for  the  exanple  of  1-D/2-D  flow  and  transport  Sec4-46 


vii 


Figure  4.50.  ConcentratioD  of  the  sixth  dissolved  chemical  in  1-D  river/stream 
at  various  times  for  the  example  of  1-D/2-D  flow  and  transporL 


Sec4-47 


Figure  4.51.  Concentration  of  the  first  dissolved  chemical  in  2-D  overland  at  various  times 

for  the  exan:q)le  of  1-D/2-D  flow  and  transport  Sec4-48 

Figure  4.52.  Concentration  of  the  second  dissolved  chemical  in  2-D  overland  at  various  times 

for  the  exan^le  of  1-D/2-D  flow  and  transport  Sec4-49 

Figure  4.53.  Concentration  of  the  third  dissolved  chemical  in  2-D  overland  at  various  times 

for  die  exanq}le  of  1-D/2-D  flow  and  transport  Sec4-50 

Figure  4.54.  Concentration  of  the  fotirth  dissolved  chemical  in  2-D  overland  at  various  times 

for  the  exanqjle  of  1-D/2-D  flow  and  transport  Sec4-5 1 

Figure  4.55.  Concentration  of  the  fifth  dissolved  chemical  in  2-D  overland  at  various  times 

for  the  exan^le  of  1-D/2-D  flow  and  transport  Sec4-52 

Figure  4.56.  Concentration  of  the  sixth  dissolved  chemical  in  2-D  overland  at  various  times 

for  the  example  of  1-D/2-D  flow  and  transport  Sec4-53 


Preface 


The  report  herein  was  prepared  for  the  Athens  Ecosystems  Research  Division,  Office  of 
Research  and  Development,  U.S.  Environmental  Protection  Agency. 

The  study  was  conducted  in  the  Hydraulics  Laboratory  (HL)  of  the  U.S.  Army  Engineer 
Waterways  Experiment  Station  (WES)  from  1995  to  1997  under  the  direction  of  Messrs.  F.  A. 
Herrmann,  Jr.,  Director,  HL;  R.  A.  Sager,  Assistant  Director,  HL;  and  Dr.  William  D.  Martin, 
Chief,  Hydrosciences  Division,  (HD)  HL. 

The  report  was  prepared  by  Drs.  Gour-Tsyh  Yeh,  Hwai-Pmg  Cheng,  and  Jing-Ru  Cheng, 
Pennsylvania  State  University,  University  Park,  PA;  and  Dr.  Hsin-Chi  J.  Lin,  Watershed 
Systems  Group,  HD. 

This  report  is  being  published  by  the  WES  Coastal  and  Hydraulics  Laboratory  (CHL).  The 
CHL  was  formed  in  October  1996  with  the  merger  of  the  WES  Coastal  Engineering  Research 
Center  and  Hydraulics  Laboratory.  Dr.  James  R.  Houston  is  the  Director  of  the  CHL,  and 
Mr.  Charles  C.  Calhoun,  Jr.,  is  the  Assistant  Director. 

At  the  time  of  publication  of  this  report.  Director  of  WES  was  Dr.  Robert  W.  Whalin. 
Commander  was  COL  Robin  R.  Cababa,  EN. 


IX 


SUMMARY 


This  report  presents  the  development  of  a  numerical  model  simulating  water  flow, 
contaminant  transport,  and  sediment  transport  in  watershed  systems.  A  watershed  system 
includes  an  overland  regime,  a  river/stream  network,  and  subsiuface  media.  The  model  is  ' 
composed  of  two  modules:  flow  and  transport.  Three  options  are  provided  in  modeling  the  flow 
module  in  river/stream  network  and  overland  regime:  the  kinematic  wave  approach,  diffusion 
wave  approach,  and  dynamic  wave  approach.  The  kinematic  and  diffusion  wave  ^proaches  are 
known  to  be  numerically  robust  in  terms  of  numerical  convergency  and  stability,  i.e.,  they  can 
generate  convergent  and  stable  simulations  over  a  wide  range  of  ground  surface  slopes  in  the 
entire  watershed.  The  question  is  the  accuracy  of  these  simulations.  The  kinematic  wave 
approach  usually  produces  accurate  solutions  only  over  the  region  of  steep  slopes.  The  diffusion 
wave  ^roach  normally  gives  accurate  solutions  over  the  region  of  mild  to  steep  slopes. 
However,  neither  £q>proach  has  the  ability  to  yield  accurate  solutions  over  the  region  of  small 
slopes,  in  which  the  inertial  forces  are  no  longer  negligible  compared  to  the  gravitational  forces. 
The  kinematic  wave  ^proach  cannot  even  address  the  problems  of  backwater  effects.  On  the 
other  hand,  a  dynamic  wave  ^proach,  having  included  all  forces,  can  theoretically  have  the 
potential  to  generate  accurate  simulations  over  all  ranges  of  slopes  in  a  watershed. 

Unfortunately,  the  dynamic  wave  £q)proaches  are  not  muneiically  robust  in  terms  of  numerical 
convergency  and  stability.  Even  with  the  physically  natural  method  of  characteristics,  not  to 
mention  the  convention^  finite  difference  and  finite  element  methods,  it  is  very  difficult  to  have 
a  convergent  and  stable  solution  over  the  region  of  steep  to  mild  slopes.  This  is  peih^s  the 
reason  that  no  fiilly  dynamic  wave  models  have  been  developed  for  applications  to  watersheds  in 
which  the  ground  surface  slopes  range  from  steep  and  mild  to  small.  The  dilemma  is  that: 
kinematic/diffusion  wave  approaches  are  numerically  robust  over  all  ranges  of  slopes  but 
produce  inaccurate  solutions  over  the  region  of  small  slopes;  the  dynamic  wave  approaches  can 
deliver  accurate  solutions  over  all  ranges  of  slopes  but  are  not  numerically  robust  over  the  region 
of  steep  to  mild  slopes.  Therefore,  it  is  desirable  to  develop  a  hybrid  model,  in  which  an 
adaptive  selection  of  kinematic,  diffusive,  or  dynamic  wave  approaches  can  be  made  over 
various  regions  of  different  slopes.  Such  a  model  should  deliver  both  numerical  robxismess  and 
accuracy  over  all  ranges  of  slopes  in  a  watershed.  The  remaining  research  problem  is  the 
adaptive  mechanisms:  under  what  slopes  a  dynamic  wave  approach  should  be  employed  and 
under  what  slopes  a  kinematic  or  diffusion  wave  approach  should  be  adapted  automatically  by 
the  code. 

In  the  transport  module  for  the  river/stream  network  and  overland  regime,  both 
contaminant  and  sediment  transport  are  taken  into  account  A  sediment  particle  can  deposit  on 
the  ground  surface  to  become  a  bed  sediment  through  deposition  and  resuspend  back  to  the 
water  body  to  become  a  suspended  sediment  through  erosion.  A  contaminant  species  may  be  a 
dissolved  chemical  in  water  phase,  an  absorbed  chemical  on  suspended  sediments,  or  an 
adsorbed  chemical  on  bed  sediments.  A  dissolved  chemical  can  interact  with  other  dissolved 
chemicals  through  aqueous  complexation  reactions  and  can  be  adsorbed  onto  sediments  to  form 
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its  respective  particulate  chemicals.  Chemical  kinetics  based  on  the  collision  theory  is  used  to 
describe  the  interaction  among  chemicals. 

In  solving  the  diffusion  wave  flow  equations,  we  employed  the  backward  method  of 
characteristics  and  all  the  nonlinear  coefficient/source/sink  terms  are  estimated  along  the  flow 
characteristics.  Thus,  we  computed  water  depth  by  using  the  Lagrangian  approach  where 
fictitious  particles  are  backward  tracked.  The  Picard  method  was  applied  to  deal  with  the  non¬ 
linearity  of  the  flow  equations.  The  predictor-corrector  numerical  scheme  was  employed  to 
solve  transport  equations.  The  Newton-Raphson  method  was  used  to  solve  the  set  of  algebraic 
equations  describing  chemical  kinetics  among  all  chemical  species. 

A  total  of  eight  groups  of  exan:q>le  problems  were  given  in  this  report  to  demonstrate  the 
capability  of  this  model.  Continuing  work  is  underway  to  incorporate  a  three-dimensional 
subsurface  flow  and  chemical  transport  model  into  this  watershed  model.  The  Richards’ 
equation  and  advection-dispersion  reactive  chemical  transport  equations  wiQ  form  the  basis  to 
simulate  the  subsurface  flow  and  chemical  transport  module  m  saturated-unsaturated  media. 

The  con^utational  module  of  subsiuf ace  flow  and  reactive  chemical  transport  will  be  developed 
based  on  a  model  of  coupled  density  dependent  flow  and  chemical  transport  through  saturated- 
unsaturated  media. 
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1  INTRODUCTION 


This  report  presents  a  numerical  model  designed  to  simulate  water  flow  and  contanoinant 
and  sediment  transport  in  watershed  systems.  This  watershed  model  includes  a  one-dimensional 
river/stream  network  flow  module,  a  one-dimensional  river/stream  network  transport  module,  a  two- 
dimensional  overland  flow  module,  and  a  two-dimensional  overland  transport  module.  A  three- 
dimensional  subsurface  flow  and  transport  model  is  to  be  incorporated  with  the  current  watershed 
model  to  link  surface  and  subsurface  systems  through  infiltration.  This  watershed  model  can  be  used 
to  simulate  flows  alone,  sediment  transport  alone,  reactive  chemical  transport  alone,  or  flow  and 
sediment  and  reactive  chemical  transport  simultaneously.  When  both  flow  and  transport  are 
simulated,  the  flow  fields  including  the  velocity  and  water  depth  are  computed  first.  Then  the 
transport  are  calculated  using  the  flow  field  from  the  flow  computations  at  each  time  step.  In  other 
words,  the  feedback  of  transport  on  flow  is  not  considered  (e.g.,  no  density  effect  is  considered). 

There  may  be  three  approaches  to  model  flow  in  a  watershed  system:  the  kinematic, 
diffusive,  and  dynamic  wave  models.  The  dynamic  wave  models  completely  describe  water  flow  but 
they  are  very  difficult  to  solve  under  some  conditions  (e.g.,  when  the  slope  of  ground  surface  is 
steep),  regardless  of  what  numerical  approach  is  employed.  On  the  other  hand,  the  diffusion  and/or 
kinematic  models  can  handle  a  wide  range  of  flow  problems  but  are  inaccurate  when  the  inertial 
terms  play  significant  roles  (e.g.,  when  the  slope  of  groundwater  surface  is  small).  Thus,  three 
options  are  provided  in  this  report:  the  kinematic  wave  model,  the  diffusion  wave  model,  and  the 
dynamic  wave  model  to  accurately  compute  water  flow  over  a  wide  range  of  conditions.  The 
diffusion/kinematic  wave  models  were  numerically  approximated  with  the  Lagrangian  method.  The 
dynamic  model  was  first  mathematically  transformed  into  characteristic  wave  equations.  Then  it  was 
numerically  solved  with  the  Lagrangian-Eulerian  method. 

The  principles  of  mass  balance  were  employed  to  derive  the  transport  equations  governing 
the  temporal-spatial  distribution  of  chemical  contaminants,  suspended  sediment,  and  bed  sediment 
Chemical  kinetics  based  on  the  collision  theory  was  used  to  present  the  relationship  between 
reactant  and  product  species  in  all  chemical  reactions  and  volatilization.  The  predictor-corrector 
numerical  scheme  was  used  to  solve  the  transport  equations.  In  the  predictor  step,  the  Lagrangian- 
Eulerian  method  was  employed  to  solve  the  advection-dispersion  transport  equation.  In  the  corrector 
step,  the  implicit  finite  difference  was  used  to  solve  the  system  of  ordinary  equations  governing  the 
chemical  kinetic  reactions.  The  nonlinearity  in  flow  and  sediment  transport  equations  is  handled 
with  the  Picard  method,  while  the  nonlinear  chemical  system  is  solved  by  using  the  Newton-Raphson 
method. 

In  the  following.  Section  2  provides  a  heuristic  derivation  of  the  governing  equations  for  flow 
in  river/stream  network  (Section  2.1),  surface  runoff  in  the  overland  regime  (Section  2.2),  sediment 
and  chemical  transport  in  river/stream  network  (Section  2.3),  and  sediment  and  chemical  transport 
m  the  overland  regime  (Section  2.4).  Section  3  includes  numerical  approaches  to  solve  governing 
equations  for  flows  in  both  the  river/stream  network  and  overland  regime.  Dynamic  wave  and 
kinematic/diffusion  wave  models  are  both  given.  This  section  also  describe  the  numerical 
approximation  to  solve  both  sediment  and  chemical  transport  in  river/stream  network  and  overland 
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regimes.  Section  4  gives  8  groups  of  example  problems  to  illustrate  the  capability  of  the  model. 
These  include:  (1)  1-D  flow,  (2)  2-D  flow,  (3)  1-D  transport,  (4)  2-D  transport,  (5)  1-D  flow  and 
transport,  (6)  2-D  flow  and  transport,  (7)  1-D  and  2-D  flow,  .and  (8)  1-D  and  2-D  flow  and  transport. 
A  summary  and  continuing  work  are  given  in  Section  5.  A  data  input  guide  is  presented  in 
Appendix  A,  program  structure  and  subroutine  were  described  in  Appendix  B,  and  required 
parameters  to  run  the  model  are  listed  in  Appendix  C. 
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2  MATHEMATICAL  BASIS 


In  this  section,  governing  equations,  initial  conditions,  and  boundary  conditions  for 
simulating  water  flow  and  contaminant  and  sediment  transport  in  watershed  systems  are  presented. 

2.1.  Water  flow  in  1-D  river/stream 


The  governing  equations  of  water  flow  in  1-D  river/stream  can  be  derived  based  on  the 
conservation  law  of  water  mass  and  hnear  momentum  [Singh,  1996],  and  can  be  written  as  follows. 


The  continuity  equation: 


aA  ,  8Q 

at  ax 


=  Sg+Sjj  S1+S1+S2 


(2.1) 


where  t  is  time  [T];  x  is  the  axis  along  the  river/stream  direction  [Lj;  A  is  cross-sectional  area  of  the 
river/stream  [L^];  Q  is  flow  rate  of  the  river/stream  [L^/Tj;  Sg  is  the  man-induced  source  [L^/T];  Sr 
is  the  source  due  to  rainfall  [L^/T];  Sj  is  the  sink  due  to  infiltration  [L^/T];  Si  and  S2  are  the  source 
terms  contributed  from  overland  flow  [L^/T]. 


The  momentum  equation: 


aQ  ^  auQ 
at  ax 


=  -gA 


5(Zo^h) 

dx 


+  _Ji+u%-u'Si+uYiS 

ax  ^  ' 


ips 


(2.2) 


where  h  is  water  depth  [L];  u  is  liver/stream  velocity  [L/T];  g  is  gravity  [L/T^];  Zq  is  bottom  elevation 
[L];  F,,  is  the  momentum  flux  due  to  eddy  viscosity  [L'^/T^];  u"  is  the  velocity  of  rainfall  along  the 
river/stream  direction  [L/T];  u‘  is  the  velocity  of  infiltration  along  the  river/stream  direction  [L/T]; 
u^^  and  are  the  velocity,  along  the  river/stream  direction  [L/T],  of  water  from  overland  to 
river/stream;  p  is  water  density  [M/L^];  P  is  surface  shear  stress  [M/T^];  P  is  bottom  shear  stress 
[M/T^]. 


Eqs.  (2.1)  and  (2.2)  are  the  governing  equations  of  a  1-D  dynamic  wave  river/stream  flow 
model.  When  the  diffusion  wave  model  is  considered,  however,  the  inertia  terms  along  the 
momentum  equation  are  assumed  negligible  when  compared  with  the  other  terms.  By  further 
assuming  negligible  surface  shear  stress,  negligible  eddy  viscosity,  and  fr  =  fr  =  u^*  =  u^^  =  0,  we 
approximate  the  river/stream  velocity  with  the  following  equation  (Hergarten  and  Neugebauer, 
1995). 


u 


-1 

R 

^3  1 

n 

1-(VZ/ 

(V(Zo+h))^^2 

5(Zo+h) 

ax 


(2.3) 


where  n  is  Maiming’s  roughness;  R  is  hydrauhc  radius  [L],  which  is  defined  as  R(x,t)  =  R*(x,h(x,t)) 
=  A/P,  P  is  the  wetted  perimeter  [L]  and  can  be  expressed  as  P(x,t)  =  P*(x,h(x,t)). 


To  achieve  transient  simulations,  either  water  depth  or  stage  must  be  given  as  the  initial 
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condition,  as  well  as  flow  velocity.  In  addition,  appropriate  boundary  conditions  need  to  be  specified 
to  match  the  corresponding  physical  system.  In  our  model,  foiu:  types  of  boundary  conditions  are 
taken  into  account  and  are  stated  as  follows. 

Water  depth-  or  stage-specified  boundary  condition:  This  condition  is  applied  when  either  water 
depth  or  stage  can  be  prescribed  at  the  river/stream  boundary  through  the  simulation  time  of  period. 
Such  a  condition  can  be  expressed  as 

h(Xj,,t)  =  hi,(t)  (2.4) 

or 

h(Xb,t)+Zo(Xj,)  =  H^O)  (2.5) 

where  x^  is  the  coordinate  of  a  river/stream  boundary;  Ij  (t)  is  a  prescribed  time-dependent  water 
depth  [L];  Hi,(t)  is  a  prescribed  time-dependent  water  stage  [L]. 

Flow  rate-specified  boundary  condition:  This  condition  is  employed  when  the  time-dependent 
incoming  flow  rate  can  be  prescribed  at  a  upstream  river/stream  boundary.  It  can  be  expressed  as 

Q(x^,t)  =  u(x^,t)A(x,,,t)  =  Qj,(t)  (2.6) 

where  Qb(t)  is  a  time-dependent  flow  rate  PL^/T]. 

Water  depth-dependent  flow  rate  boundary  condition:  This  condition  is  often  used  to  describe  the 
flow  rate  at  a  downstream  river/stream  boundary  at  which  the  flow  rate  is  a  function  of  water  depth. 
It  can  be  written  as 

Q(Xi,,t)  =  u(Xj,,t)A(Xb,t)  =  Qb(h(Xb,t))  (2.7) 

where  Qb(h(X(,,t))  is  a  water  depth-dependent  flow  rate  P^^/T]. 

Junction  bniindarv  condition:  This  condition  is  applied  to  a  boundary  of  a  river/stream  reach  when 
the  boundary  is  cormected  to  a  junction.  In  this  case,  the  stage  of  the  boundary  is  specified  as  the 
stage  of  the  junction.  That  is, 

h(Xb,t)+Zo(Xj,)  =  Hj^^^„„(t)  (2.8) 

HjunctionW  is  the  water  stage  [L]  at  the  jimction  that  is  computed  through  the  computation  of  water 
budget.  We  will  give  the  detail  of  computing  Hj^^tionCO  i®  Section  3. 

2.2.  Water  flow  in  2-D  overland 

The  governing  equations  of  2-D  overland  flow  can  be  derived  based  on  the  conservation  law 
of  water  mass  and  linear  momentum  [Wang  and  Cormor,  1975].  The  governing  equations  of  a 
dynamic  wave  model  can  be  written  as  follows. 

The  continuity  equation: 
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=  SS+R-I 


(2.9) 


8h  0uh  0vh 
_  + _  + _ 

5t  dx  dy 

where  h  is  water  depth  [L];  u  is  the  x- velocity  [L/T];  v  is  the  y- velocity  [L/T];  SS  is  the  man-induced 
source  [L/T];  R  is  the  source  due  to  rainfall  [L/T];  I  is  the  sink  due  to  infiltration  [L/T]. 


The  x-momentum  equation: 


5uh  ^  6u^h  ^  5uvh 
dt  dx  dy 


=  -gh 


d(Z,^h) 

dx 
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dx  dy 


+  (u  ^R-u'I) 


(2.10) 


where  ^  is  the  bottom  elevation  of  overland  [L];  is  the  component  of  rainfall  velocity  along  the 
x-direction  [L/T];  is  the  component  of  infiltration  velocity  along  the  x-direction  [L/T];  and  Fy, 
are  the  fluxes  due  to  eddy  viscosity  along  the  x-direction  [L^/T^];  is  the  component  of  surface 
shear  stress  along  the  x-direction  over  unit  horizontal  overland  area  [M/L/T^];  is  the  component 
of  bottom  shear  stress  along  the  x-direction  over  unit  horizontal  overland  area  [M/L/T^]. 


The  v-momentum  equation: 


dvh  ^  duvh  ^  dv^h 
dt  dx  dy 


=  -gh 


a(Zo+h) 

dy 


+  (v^R-v’I) 


(2.11) 


where  v^  is  the  component  of  rainfall  velocity  along  the  y-direction  [L/T];  i  is  the  component  of 
infiltration  velocity  along  the  y-direction  [L/T];  F^y  and  Fyy  are  the  fluxes  due  to  eddy  viscosity  along 
the  y-direction  [L^/T^];  Xy'is  the  component  of  surface  shear  stress  along  the  y-direction  over  unit 
horizontal  overland  area  [M/L/T^];  Xy^*  is  the  component  of  bottom  shear  stress  along  the  y-direction 
over  unit  horizontal  overland  area  [M/L/T^]. 


In  Eqs.  (2.10)  and  (2.1 1),  it  is  noted  that  if  R  >  0,  u*^  and  v^  are  prescribed;  otherwise,  u'  =  u 
and  v*^  =  V.  Likewise,  if  I  <  0,  ii  and  V  are  either  prescribed  or  computed  with  subsurface  flow 
models;  otherwise,  u'  =  u  and  v*  =  v. 


When  the  diffusion  wave  model  is  considered,  the  inertia  terms  in  Eqs.  (2. 10)  and  (2. 1 1)  are 
assumed  not  important  when  compared  to  the  others.  With  the  further  assumption  that  eddy 
viscosity  is  insignificant,  surface  shear  stress  is  negligible,  and  u”^  =  v"^  =  u‘  =  v*  =  0,  we  approximate 
the  velocity  (u,  v)  as  follows. 


u 


v 


-1 

h 

2/3  1 

5(Zo+h) 
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(2.12) 

(2.13) 


To  perform  transient  simulations,  water  depth  (or  stage)  and  velocity  must  be  given  as  the 
initial  conditions.  Four  types  of  boundary  conditions  are  implemented  in  our  model,  as  described 
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as  follows. 


Water  depth-  or  stage-specified  boundary  condition:  This  condition  is  applied  when  either  water 
depth  or  stage  can  be  prescribed  at  overland  boundary  nodes  through  the  simulation  time  of  period. 
Such  a  condition  can  be  expressed  as 

h(Xb,yb,t)  =  hj,(t)  (2.14) 


or 


h(Xb.yb»t)+Z(,(Xb,yb)  =  Hb(t)  (2.15) 

where  (Xb,  yb)  is  the  coordinate  of  a  overland  boundary  node;  4  (t)  is  a  prescribed  time-dependent 
water  depth  [L];  Hb(t)  is  a  prescribed  time-dependent  water  stage  [L]. 

Normal  flux-specified  boundary  condition:  This  condition  is  employed  when  the  time-dependent 
incoming  normal  flux  can  be  prescribed  at  a  upstream  overland  boundary  segment.  It  can  be 
expressed  as 

-n-q(Xb,yb.t)  =  -n-V(Xb,yb,t)h(Xb,yb,t)  =  qb(t)  (2.16) 


where  n  is  the  outward  unit  normal  vector  of  the  boundary  segment;  V  =  (u,  v);  qb(t)  is  a  time- 
dependent  normal  flux  [L^/T]. 

Water  depth-dependent  normal  flux  boundary  condition:  This  condition  is  often  used  to  describe  the 
outgoing  normal  flux  at  a  downstream  overland  boundary  segment  at  which  the  flux  is  a  function 
of  water  depth.  It  can  be  written  as 

-n-q(Xb,yb,t)  =  -n-V(Xb,yb,t)h(Xb,yb,t)  =  -qb(h(Xb,yb,t))  (2.17) 

where  qb(h(Xb,yb,t))  is  a  water  depth-dependent  normal  flux  [L^/T]. 

River/stream-  or  junction-related  boundary  condition:  This  condition  is  applied  to  a  overland 
boundary  segment  when  the  boundary  segment  is  next  to  a  river/stream  or  a  junction,  and  through 
the  segment  water  may  flow  from  overland  to  river/stream  or  from  river/stream  to  overland, 
depending  on  the  water  stages  at  both  river/stream  and  overland.  In  this  occasion,  the  normal  flux 
is  computed  based  on  either  the  water  depth  on  the  overland  boundary  or  the  difference  between 
overland  and  river/stream  water  stages.  Three  cases  are  included  in  this  type  of  boundary  condition. 

<  Case  1  >  River/stream  water  stage  is  lower  than  the  bottom  elevation  of  the  overland  boundary: 
In  this  case,  water  is  injected  to  river/stream  from  overland.  The  normal  flux  can  be  expressed  as 

-n-q(Xb,yb,t)  =  -n'V(Xb,yb,t)h(Xb,yb,t)  =  -qj,(h(Xb,yb,t))  (2.18) 

where  qb(h(Xb,yb,t))  is  a  water  depth-dependent  normal  flux  [L^/Tj. 

<  Case  2  >  River/stream  water  stage  is  higher  than  the  bottom  elevation  of  the  overland  boundary 
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but  is  lower  than  the  water  stage  of  the  overland  boundary:  In  this  case,  water  is  stiU  injected  to 
river/stream  from  overland.  The  normal  flux  can  be  expressed  as 

-n-q(Xb,yb,t)  =  -n*V(Xb,yb,t)h(Xb,yb,t)  =  -qb(AH(Xb,yb,t))  (2.19) 

AH(Xb,yb,t)  =  H(Xb,yb,t)-H^(x^,t)  (2.20) 

where  H(Xb,yb,t)  is  the  water  stage  on  the  overland  boundary  [L];  H  (j(.  ,t)  is  the  water  stage  at  the 
river/stream  related  to  the  overland  boundary  [L];  AH  is  the  stage  difference  between  river/stream 
and  overland  [L];  qb(AH(Xb,yb,t))  is  a  stage  difference-dependent  normal  flux  [L^/T]. 

<  Case  3  >  River/stream  water  stage  is  higher  than  the  water  stage  of  the  overland  boundary:  In  this 
case,  water  flows  from  river/stream  to  overland.  The  normal  flux  can  be  expressed  as 

-n-q(Xb,yb,t)  =  -n'V(Xb,yb,t)h(Xb,yb,t)  =  qb(AH(Xb,yb,t))  (2.21) 

^(Xb.yb’t)  =  H^(Xc.t)-H(Xb,yb,t)  (2.22) 

where  qb(AH(Xb,yb,t))  is  a  stage  difference-dependent  normal  flux  [L^/T]. 

23.  Contaminant  and  sediment  transport  in  1-D  river/stream 

The  transport  governing  equations  of  both  contaminants  and  sediments  in  1-D  river/stream 
system  can  be  derived  base  on  the  conservation  law  of  material  mass  [Yeh,  1983].  They  can  be 
written  as  follows. 


Continuity  equation  for  suspended  sediments: 


d(ASJ  d(QSJ  d 


,K  A— ^ 
dt  dx  dx  dx 


=  M;+M“+(R„-D„)P  ne[l,N3]  (2.23) 


Continuity  equation  for  bed  sediments: 
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dt 

Continuity  equation  for  dissolved  chemicals: 
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=  (D.C^-R.C„‘)-AiM.C„‘-k„‘X  C.‘— C'  netlJ».],ietl,NJ  (2.27) 


where 

A  =  River/stream  cross-sectional  area  [L^]; 

a^j  =  Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 

reaction  when  this  dissolved  chemical  appears  as  a  reactant  chemical; 

B  =  Top  river/stream  width  [L]; 

bmj  =  Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 

reaction  when  this  dissolved  chemical  appears  as  a  product  chemical; 

C  "  =  Cross-sectionally-averaged  concentration  of  the  I-th  dissolved  chemical  [M/L^]; 

Q™'  =  Concentration  of  the  I-th  dissolved  chemical  in  rainfall  [M/L^j; 

Ci^  =  Concentration  of  the  I-th  dissolved  chemical  in  the  subsurface  [M/L^]; 

Cj’  =  Cross-sectionally-averaged  particulate  chemical  concentration  on  bed  sediment  of  the  n-th 
fraction  size  [M/M]; 

-  Cross-sectionaUy-averaged  particulate  chemical  concentration  on  suspended  sediment  of 
the  n-th  fraction  size  [M/MJ; 

Dn  =  Deposition  rate  of  the  n-th  size  fraction  sediment  [M/L^/T]; 

I  =  Infiltration  from  river/stream  to  subsurface  [L^/T]; 


K,  =  Longimdinal  dispersion  coefficient  [L^/T]; 

kj®*’  =Backward  volatilization  rate  constant  associated  with  the  I-th  dissolved  chemical  in  the 
atmosphere  [M/atm/L^/T]; 

=  Forward  volatilization  rate  constant  associated  with  the  I-th  dissolved  chemical  in  the 
atmosphere  [l/TJ; 

kni®’’  =  Backward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [l/Tj; 
kni^  =  Forward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [L^/M/T]; 
kjjj*  =  Backward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 

k^*^  =  Forward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 

kni’”’  =  Backward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on 
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suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

=  Forward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [L^/M/T]; 

Mn  =  Sediment  mass  per  unit  bed  area  of  the  n-th  size  fraction  [M/L^] ; 

=Source  of  the  n-th  size  fraction  sediment  [M/L7T]; 

Mn“  =  Source  of  the  n-th  size  fraction  sediment  from  overland  [M/L/T];  It  is  equal  to 
RiSn“'+R2S„°^,  where  S„“'  and  Sj,°^  are  the  associated  suspended  sediment  concentration  of 
the  n-th  size  fraction  from  overland. 

Mjjj“  =  Source  of  the  I-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size 
[M/L/T]; 

=  Source  of  the  I-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size  from 
overland  [UfUT]-,  It  is  equal  to  RjS  “'Q“'+R2S„°^C^°^,  where  and  are  the 
associated  I-th  particulate  chemical  concentration  on  suspended  sediment  of  the  n-th  size 
fraction  from  overland. 

=  Source  of  the  I-th  dissolved  chemical  [M/L/T]; 

M,cw  =Rainfall  source  of  the  I-th  dissolved  chemical  [M/L/T];  It  is  equal  to  RQ™'  if  R  is  positive. 
Otherwise,  it  is  zero. 

Mj“'*'  =Iiifiltration  sink  of  the  I-th  dissolved  chemical  [M/L/T].  It  is  equatl  to  IC  *  if  I  is  positive. 

Otherwise,  it  is  IQ®"  representing  a  source  from  the  subsurface 
M.COW  _  of  the  I-th  dissolved  chemical  from  overland  [M/L/T] ;  it  is  equal  to  R  f  °"4-R  f 

where  Q°"^  and  are  the  associated  I-th  dissolved  chemical  concentrations  from 
overland. 

Nj  =  Number  of  dissolved  chemicals; 

Nj  =  Number  of  sizes  of  sediments; 

P  =  Wetted  perimeter  [L]; 

pj  =  Partial  pressure  of  the  I-th  dissolved  chemical  in  the  atmosphere  [atm]; 

Q  =  River/stream  flow  rate  [L^/T] ; 

R  =  Rainfall  to  river/stream  [L^/T]; 

R„  =  Erosion  rate  of  the  n-th  size  fraction  sediment  [M/L^/T]; 

Rj  R2  =  Surface  runoff  from  overland  to  river/stream  [L^/T];  the  subscripts  1  and  2  are  used  to 
differentiate  the  flows  through  the  two  river/stream-overland  interfaces  because  they  usually 
are  not  the  same  in  practice. 

=  Cross-sectionally-averaged  sediment  concentration  of  the  n-th  fraction  size  [M/L^]; 
t  =  Time  [T]; 

=  River/stream  coordinate  [L]; 

=  Combined  first  order  degradation  rate  constant  of  the  I-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [1/T]; 

Ajjj®  =  Combined  first  order  degradation  rate  constant  of  the  I-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

A  "  =  Combined  first  order  degradation  rate  constant  of  the  I-th  dissolved  chemical  [1/T]; 

In  obtaining  Eqs.  (2.25)  through  (2.27),  the  following  reactions  are  considered. 

(1)  Aqueous  complexation  reactions:  and  k^,'^  as  backward  and  forward  reaction  rate  constants. 
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(2.29) 


R 'Cncc')** -cncCi’)'’- 

j'l  j=i 

where  R  is  defined  as  the  reaction  rate  of  the  aqueous  complexation  reaction. 


(2)  Adsorption/desorption  between  the  dissolved  phase  and  suspended  sediment:  and  Iq^*^  as 

backward  and  forward  reaction  rate  constants. 


ie[l,NJ,ne[l,N^] 

(2.30) 

R  =  k^S„Cr  - 

(2.31) 

where  R  is  defined  as  the  reaction  rate  of  the  adsorption  reaction. 

(3)  Adsorption/desorption  between  the  dissolved  phase  and  bed  sediment:  k^** 
and  forward  reaction  rate  constants. 

and  kni**^  as  backward 

i6[lJ^J,n6[l,NJ 

(2.32) 

(2.33) 

where  R  is  defined  as  the  reaction  rate  of  the  adsorption  reaction. 

(4)  Volatilization  between  the  dissolved  phase  and  atmosphere:  Iq®*’  and  Iq^as  backward  and  forward 
reaction  rate  constants. 

q"'  -  pj  ie[l,NJ 

(2.34) 

R  =  kfc.;^  -  ktVi 

(2.35) 

where  R  is  dejSned  as  the  reaction  rate  of  the  volatilization  reaction.  In  Eqs.  (2.28),  (2.30),  (2.32), 
and  (2.34),  the  over-line  is  used  to  present  the  formula,  rather  than  the  concentration,  of  a  chemical 
or  a  sediment. 


The  concentrations  of  all  contaminant  species  and  sediments  must  be  given  initially  for 
transient  simulations.  In  our  model,  both  bed  sediments  and  particulate  chemicals  sorbed  on  the  bed 
sediments  are  considered  to  be  immobile,  as  described  by  Eqs.  (2.24)  and  (2.27).  Therefore, 
boundary  conditions  are  needed  for  suspended  sediments,  dissolved  chemicals,  and  particulate 
chemicals  on  suspended  sediments.  Four  types  of  boundary  conditions  are  taken  into  account  as 
stated  as  follows. 


Dirichlet  boundary  condition:  This  conditions  is  applied  when  concentration  is  given  at  the 
boundary.  That  is, 

C(Xb,t)  =  Cb(t)  (2.36) 

where  C  can  be  the  Sj,,  C*,  or  QCt)  is  a  time-dependent  concentration  [M/L^]. 

Variable  boundary  condition:  This  boimdary  condition  is  employed  when  the  flow  direction  would 
change  with  time  during  simulations.  Two  cases  are  considered,  regarding  to  the  flow  direction  on 
the  boundary. 

<  Case  1  >  Flow  is  coming  in  from  outside: 

QC(x„t)-AK,-^^^  =QC,(t)  (2.37) 

OX  J 

<  Case  2  >  Flow  is  going  out  from  inside: 

5C(x.,t) 

-AIC - ^  =0  on  By  (2.38) 

dx 

where  0,(0  is  a  time-dependent  concentration  [M/L^]  which  is  associated  with  the  incoming  flow. 


Cauchy  boundary  condition:  This  boundary  condition  is  employed  when  the  total  material  flow  rate 
is  given  at  the  river/stream  boundary.  Usually,  this  boundary  is  a  upstream  boundary  node.  The 
conditions  can  be  expressed  as 

5C(Xv,t)  1  . 

n  QC(x,,t)-AK,— ^  =  Qb^(t)  (2.39) 

OX 

where  (3b‘^(t)  is  material  flow  rate  [M/T];  n  =  1  if  the  boundary  is  a  upstream  boundary  node,  or  n  = 
-1  if  it  is  a  downstream  boundary  node. 

Neumann  boundary  condition:  This  boundary  condition  is  used  when  the  diffusive  material  flow  rate 
is  known  at  the  river/stream  boundary  node.  It  can  be  written  as 

0C(x.  ,t)  - 

-nAK,— ^  =  Qb"(t)  (2.40) 

where  Qb‘^(t)  is  material  flow  rate  [M/T]. 

2.4.  Contaminant  and  sediment  transport  in  2-D  overland 

The  equations  governing  contaminant  and  sediment  transport  in  2-D  overland  can  be  derived 
according  to  the  conservation  law  of  material  mass.  They  can  be  written  as  follows. 
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^^+V-(qS„)  =  V-[hK-VS^]+MXR„-D„) 


(2.41) 


Continuity  equation  for  bed  sediments: 


=  D,-R„  ne[l,NJ 


(2.42) 


Continuity  equation  for  dissolved  chemicals: 


a(hc*) 


+V-(qq'*') 


,af  N 


=  v|hK-VC  -  Arhq’'+hki=“’(pj  —CD  +E  l4'’S„h(C^  --^C*) 

K  "=1  K 


N. 

i-i  Ws  ,  V 


k5 

i  *Tn  n 


ECM„(C^-^q")-^E  (a^j-b^pCh  n  (Cj")”"^—!!  (Cj*)^^ 


(2.43) 


Mcrw  •*  /r  aw 

i 


ie[W 


Continuity  equation  for  particulate  chemical  on  suspended  sediments: 


5(hS„C^) 


+V-(qS  C^) 


=  v{hK-V(S„C^)]  -l4'’S„h(C^ 


(2.44) 


ne[l^J,  i€[l,NJ 

Continuity  equation  for  particulate  chemica]  on  bed  sediments: 

-  (D.C^-R.C„‘)-X‘m.C„‘-CH,  C-^C,”  neIlJ^.],ie[l,NJ  (2.45) 


where 

h  =  Water  depth  [L]; 

a^jj  =  Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  reactant  chemical; 
bnjj  =  Stoichiometric  coefficient  of  the  j-th  dissolved  chemical  in  the  m-th  aqueous  complexation 
reaction  when  this  dissolved  chemical  appears  as  a  product  chemical; 

C  "  =  Depth-averaged  concentration  of  the  I-th  dissolved  chemical  [M/L^]; 

q™  =  Concentration  of  the  I-th  dissolved  chemical  in  rainfall  [M/L^]; 

Cj^  =  Concentration  of  the  I-th  dissolved  chemical  in  the  subsurface  [M/L^]; 


CjJ^  =  Depth-averaged  particulate  chemical  concentration  on  bed  sediment  of  the  n-th  fraction 
size  [M/M]; 

Cnj*  =  Depth-averaged  particulate  chemical  concentration  on  suspended  sediment  of  the  n-th 
fraction  size  [M/M]; 

Djj  =  Deposition  rate  of  the  n-th  size  fraction  sediment  [M/L^/T]; 

I  =  Infiltration  from  overland  to  subsurface  [L/T]; 

K  =  Dispersion  coefficient  tensor  [L^/T]; 

=  Backward  volatilization  rate  constant  associated  with  the  I-th  dissolved  chemical  in  the 
atmosphere  [M/atm/L^/T]; 

k;^  =  Forward  volatilization  rate  constant  associated  with  the  I-th  dissolved  chemical  in  the 

atmosphere  [1/T]; 

=  Backward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 
k^j®^  =  Forward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on 

suspended  sediment  of  the  n-th  fraction  size  [L^/M/T]; 
knj*  =  Backward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 
knj'^  =  Forward  rate  constant  of  the  m-th  aqueous  complexation  reaction  [reaction-dependent]; 
=  Backward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on 
suspended  sediment  of  the  n-th  fraction  size  [1/T]; 
kni**^  =  Forward  adsorption  rate  constant  associated  with  the  I-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [L^/M/T]; 

M„  =  Sediment  mass  per  unit  bed  area  of  the  n-th  size  fraction  [M/L^]; 

Mj,®  =  Source  of  the  n-th  size  fraction  sediment  [M/L^/T]; 

Mni“  =  Source  of  the  I-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size 
[M/L^/T]; 

Mj®*  =  Source  of  the  I-th  dissolved  chemical  [M/L^/T]; 

M.crw  _  Rajnfaji  source  of  the  I-th  dissolved  chemical  [M/L^/T].  It  is  equal  to  rC  ™  if  r  is  positive. 
Otherwise,  it  is  zero. 

Mi“"  =Infiltration  sink  of  the  I-th  dissolved  chemical  [M/L^/T].  It  is  equal  to  iC  *  if  I  is  positive. 

Otherwise,  it  is  iQ®^  representing  a  source  from  the  subsurface. 

Nj  =  Number  of  dissolved  chemicals; 

Nj  =  Number  of  sizes  of  sediments; 

Pi  =  Gaseous  pressure  in  the  atmosphere  associated  with  the  I-th  dissolved  chemical  [atm]; 
q  =  Flux  of  overland  flow  [L^/T] ; 

R  =  Rainfall  to  overland  [L/T]; 

Rn  =  Erosion  rate  of  the  n-th  size  fraction  sediment  [M/L^/T]; 

Sq  =  Depth-averaged  sediment  concentration  of  the  n-th  fraction  size  [M/L^]; 

SS  =  External  source/sink  [L/t]; 

t  =Time[T]; 

(x,y)  =  Horizontal  coordinates  [L]; 

Ani^*  =  Combined  first  order  degradation  rate  constant  of  the  I-th  particulate  chemical  on  bed 
sediment  of  the  n-th  fraction  size  [1/T]; 

Ani^  =  Combined  first  order  degradation  rate  constant  of  the  I-th  particulate  chemical  on 
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suspended  sediment  of  the  n-th  fraction  size  [1/T]; 

=Combined  first  order  degradation  rate  constant  of  the  I-th  dissolved  chemical  [1/T]; 


In  obtaining  the  above  equations,  the  reactions  described  with  Eqs.  (2.28)  through  (2.35)  are 
considered.  To  achieve  transient  simulations,  the  concentrations  of  contaminants  and  sediments 
must  be  provided  initially.  Four  types  of  boundary  conditions  can  be  used  for  mobile  materials,  i.e., 
suspended  sediments,  dissolved  chemicals,  and  particulate  chemicals  on  suspended  sediments. 
These  four  boimdary  conditions  are 

Dirichlet  boundary  condition:  This  conditions  is  applied  when  concentration  is  given  at  the 
boundary.  That  is, 

C(Xb,yb,t)  =  Cb(t)  (2.46) 

where  C  can  be  the  S„,  C-^,  or  S„Cnj*;  Cb(t)  is  a  time-dependent  concentration  [M/L^]. 

Variable  boundary  condition:  This  boundary  condition  is  employed  when  the  flow  direction  would 
change  with  time  during  simulations.  Two  cases  are  considered,  regarding  to  the  flow  direction  on 
the  overland  boundary  segment. 

<  Case  1  >  Flow  is  coming  in  from  outside: 

-n-[qC(Xb,yb,t)-hK-VC(Xb,yb,t)]  =  -n-qCb(t)  (2.47) 

<  Case  2  >  Flow  is  going  out  from  inside: 

n-(-hK*VC(Xb,yb,t))  =  0  (2.48) 

where  n  is  the  outward  unit  normal  vector  of  the  boundary  segment;  Cb(t)  is  a  time-dependent 
concentration  [M/L^],  which  is  associated  with  the  incoming  flow. 

Cauchy  boundary  condition:  This  condition  is  applied  when  the  total  incoming  material  flux  is 
prescribed  as  a  function  of  time  on  an  overland  boundary  segment.  It  can  be  written  as 

-n-[qC(x,,yb,t)-hK-VC(Xb,yb,t)]  =  qb'(t)  (2.49) 

where  qb'(t)  is  a  time-dependent  Cauchy  flux  [M/T/L] 

Neumann  boundary  condition:  This  conditions  is  employed  when  the  incoming  diffusive  material 
flux  can  be  prescribed  on  a  boundary  segment.  It  is  written  as 

-n-(-hK-VC(x,,yb,t))  =  qb-^d)  (2.50) 

where  qb‘^(t)  is  a  time-dependent  Neumarm  flux  [M/T/L]. 
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3  NUMERICAL  APPROACHES 


In  this  section,  the  numerical  approaches  employed  to  solve  the  governing  equations  of  flow 
and  transport  given  in  the  previous  section  are  presented. 

3.1.  Solving  the  1-D  river/stream  flow  equations 

As  mentioned  earlier  in  this  report,  we  desire  to  implement  a  hybrid  model  to  accurately 
simulation  surface  water  flow  under  a  wide  range  of  physical  conditions  though  it  is  still  under 
investigation  and  further  study  is  required.  In  our  investigation  to  date,  we  would  apply  the  method 
of  characteristics  to  solve  the  dynamical  wave  model  and  would  use  the  Lagrangian  approach  to 
solve  both  the  diffusion  wave  and  the  kinematic  wave  models  in  the  hybrid  model  that  is  composed 
of  the  aforementioned  three  wave  models.  In  this  and  the  next  subsections,  we  will  present  the 
numerical  approaches  used  in  the  method  of  characteristics  and  the  Lagragian  approach  for  solving 
the  1-D  river/stream  flow  and  2-D  overland  flow  equations,  respectively.  In  either  approach,  the 
Picard  method  is  employed  to  deal  with  the  nonlinearity. 

3.1.1.  Method  of  characteristics  for  1-D  dynamic  wave  model 

Recall  Eqs.  (2.1)  and  (2.2), 

— +-^  =  Sc+S„-Si  +  S,+S,  (31) 

at  dx  S  R  I  1  2 


dQ  ^  duQ 
dt  dx 


=  -gA 


d(Zo^h) 

dx 


d'P 

dx  ^  ^ 


Ts 


We  also  have 


(3.2) 


dt  dx  ^  dt  dx 


5x  dx  dh  dx 


(3.4) 


and  assume 


dA  „  dh 
■ft 


.  9b; 

b;  +h — ^ 

"  dh 


dt 


dF 

X 

dx 


dx 


*  5u 

d 

_  .  du 

vA— 

vB  h— 

dx 

dx 

9x 

(3.5) 


(3.6) 


where  v  is  the  eddy  viscosity  coefficient  [^/T];  B,(XT)  (=  Bt*(x,h(XT)))  is  the  top  river/stream  width 
[L];  Ba(XT)  (=  B/(x,h(XT)))  is  the  average  river/stream  width  [L].  Thus,  Eqs.  (3.1)  and  (3.2)  can 
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be  rewritten  as  follows  after  letting  H  =  h  +  Zq  and  some  mathematical  manipulation. 

an  an  au  i  c  c  e  c  x  uh 

at  ax  ax  B,  ^  ^  ^  ^  ^  ax  ax 


au  au  an  ia„,au 

dt  dx  ^dx  hB,  dx  "  ax 

a 


+— ^  -uSg  +(u  '^-u)Sj^-(u  *-u)Sj  +  (u^^  “U)Sj  +(u^^  -u)S2  +  '^-— ^ 


Thus,  Eqs.  (3.7)  and  (3.8)  can  be  written  in  matrix  form  as 

at  ax 


where 


E  =  {H  u}’’ 


(3.10) 


A  = 

.g  “ 


(3.11) 


in  which 


R  .  {  R,  R,f 


(3.12) 


1  uh  aB.’  aZn 

R,  =  — (Sg+SR-S,  +  S, +S,)-— — ^+u — ^ 

^  B,  ®  ^  ^  ^  B^  ax  ax 


(3.13) 


Rj  =  vB^h— 

^  hB^  ax[  “  ax 


+— ^  -uSg+(u  '^-u)Sj^-(u‘-u)Sj  +  (u^*  -u)Sj  +(u^^-u)S,  + 
hB^L  P  . 


Eq.  (3.9)  can  be  written  as 


— +A‘*—  =  RJ+RD 

at  ax 


(3.14) 


(3.15) 


where 
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A"  = 


(3.16) 


RD  = 


f  =  i  1  d  [  ,  ^ 

RD  I - — 

2j  hB^dx[  ^  dx 


(3.17) 


f  R 

I  '  ax 

'’1  k-RD,-gf 


Eq.  (3.15)  can  be  further  written  as 


(3.18) 


=  RJ+RD 


(3.19) 


where 


Let  E*  be  the  solution  of 


We  have,  from  Eq.  (3.19) 


DE  _  ^  d  9E 
Dt  at  ax 


M  =RJ 

Dt  at  ax 


E-EP 


=  RJ+RD 


(3.20) 


(3.21) 


(3.22) 


where  Ep  represents  the  Lagrangian  value  of  E.  From  Eq.  (3.21) 

E*-EP 


(3.23) 


Subtracting  Eq.  (3.23)  from  Eq.  (3.22)  yields 


=  RD 


(3.24) 


Based  on  the  above,  we  mean  to  solve  Eq.  (3.21)  for  E*  at  first  and  solve  Eq.  (3.24)  for  E  based  on 
E*.  Eq.  (3.21)  is  solved  by  the  method  of  characteristics  as  follows. 


Eq.  (3.21)  can  be  written  as 
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where 


RJ  = 

The  eigenvalues  and  eigenvectors  of  A  are 

Aj  =  u  + 


l“.l 

R.  1 

Ki 

11 

[R,-RD, 

Now,  we  define 


Thus 


Set 


N 


ghB, 

Cl  =  ' 

hB,  1. 

Bt 

1 

[2N 

gB,  2 

Aj  =  u- 


ghB, 

B. 


1 

hB,  1 

. 

gB,  2 

L  = 


c _ c_ 

2g  2g 

1  1 

2  2 


-1  _ 


^  1 


g 


aw  =  L'^dE  = 


1  1 


-1  1 
c 


I  an 

I  du  I 


Multiplying  both  side  of  Eq.  (3.25)  by  L'^  yields 

L-*— +L-‘ALL-‘—  =  L'lRI 

at  ax 


or 


aw 

at 


u+c  0 
0  u  -c 


5W  ^ ,  -n 


ax 


=  L-*RI 


(3.26) 


(3.27) 


(3.28) 


(3.29) 


(3.30) 


(3.31) 


(3.32) 


(3.33) 
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or 


where 


DW 

Dt 


L-^RI 


c  = 


ghB, 

B. 


Eq.  (3.34)  can  be  discretized,  in  time,  as  follows. 


£ - + - 

c  ATj  ATj 


(3.34) 


(3.35) 


(3.36) 


- + - 

c  ATj  ATj 


(3.37) 


where  Hj*,  Uj*,  and  Axj  are  determined  by  backward  tracking  along  the  first  characteristic;  Hj*,  Uj*, 
and  Atj  are  determined  by  backward  tracking  along  the  second  characteristic. 


Backward  tracking  along  characteristics  for  1-D  channel  flow 


Figure  3.1.  Tracking  along  characteristics  in  solving  1-D  dynamic  wave  equation. 


and 


H*  ttD+I  ttD+I 

1  “ 


(3.38) 
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*  n+1  n+1  , 

=  ajUfci  +a2Ut2 

(3.39) 

h;  =  bjHjr^b2l^r'^b3 

(3.40) 

u;  =  bjUjr^b2Ujr'+b, 

(3.41) 

in  which  kl  and  k2  are  nodes  of  the  element  that  the  backward  tracking,  along  the  first  characteristic, 
stops  in;  jl  and  j2  are  nodes  of  the  element  that  the  backward  tracking,  along  the  second 
characteristic,  stops  in.  (see  the  above  figure) 

Note:  1.  Up  bp  and  i>2  cire  within  the  range  of  [0,1  ]. 

2.  We  may  use  two  given  parameters  to  determine  where  to  stop  in  the  backward  tracking: 
one  is  for  controlling  tracking  time  and  the  other  one  is  for  controlling  tracking  distance. 


Multiplying  Eqs.  (3.36)  and  (3.37)  with  cross-sectional  area  yields 

ghB^ 
cAt, 


c  5b; 

_gdZQ 

\n  fii  1+  (u  Ui  f+nts^ 

B^  dx 

c  dx 

u+^PhK+Sg+Sj^-Sj+Sj  +S2)u 


=  -^(Ss+SR-SiH-Sj+S2)+(u’^SR-u*Sj+uYiSi+uY2S2)+^+-A^vhB,^j 


(3.42) 


-ghB, 

cAt, 


At, 


g3Zo 


Bj  dx  c  dx 


u  +^PhK  +  Sg  ■'■Sjj  ~Sj  +  Sj  +  S2^u 


=  'S^-u ‘s,.u «S,  vhB.^I 

In  obtaining  Eqs.  (3.42)  and  (3.43),  the  following  relationships  have  been  employed. 


(3.43) 


—  =  PhKU  (3.44) 

P 


P  P 


(3.45) 


When  Hi*,  Uj*,  Hj*,  and  U2*are  determined  explicitly  by  using  the  spatial  reach  out  option  in 
backward  tracking  (i.e.,  track  backward  all  the  way  to  the  previous  time),  Eqs.  (3.42)  and  (3.43)  can 
be  solved  for  (H*,  u*)  node  by  node  as  follows. 

Eqs.  (3.42)  and  (3.43),  after  multiplied  by  Atj  and  Ai:2»  respectively,  can  be  written  as 

aiiH+aj2U=bi  (3.46) 
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a2iH+a22U  =  bj 


where 


^11  =  cB^ 


^  =  hB 


Bj  8x  c  dx 


ATi 


+^PhK+S5+Sjj-Sj  +  Sj  +S2)ATj 


(3.47) 

(3.48) 

(3.49) 


b,  =cB,Hi%hBX 

cS  B  (3.50) 

^(Ss*SE-S,*S,*S,)tAt,^'S^-uiS,»u«S,tu’^S2)+-i - ^ 


^2  “ 


1- 


=  -cB 

c5b;  gdz. 


Bj  6x  c  3x 


At, 


+  (PhK+S5+Sj^-Sj+Sj  +S2)At2 


(3.51) 

(3.52) 


b2  =  -cB,H2%hBX 


-■^^(Ss  *Se  -S,  *S,  »S,).  At,^  'S,  -u  ‘S,  +u  S,  .u"S,)» 

Therefore,  we  solve  Eqs.  (3.46)  and  (3.47)  for  and  u*  Now,  we  can  solve  Eq.  (3.24)  as 
follows.  Eq.  (3.24)  can  be  written  in  details  as 


H-H* 

At 


=  0 


,  ±(  vhB 

At  5x  (  ^  8x 


(3.54) 


(3.55) 


Eq.  (3.54)  gives  that  H  =  H*,  while  Eq.  (3.55)  can  be  discretized,  in  the  finite  element 
method,  as 


At 


where 


[QA]{u}+[QD]{u}=  {QR}h-{BQ} 


Q^j  '  E  /  N.'Np'dR 
ceM  J 


(3.56) 


(3.57) 
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(3.58) 


QDij  =  E  f  VN;hvB,VNp'dR 

C€M.  •' 


QRi  =  E  f  n; 

eeuJ 


e  hB,u* 


At 


dR 


(3.59) 


BQ,  =  E  /N;nhB.|dB 


eeM, 


(3.60) 


in  Eq.  (3.60),  n  =  -1  for  upstream  boundary  nodes  while  n  =  1  for  downstream  boundary  nodes. 


In  solving  Eqs.  (3.42)  and  (3.43)  at  boundary  nodes,  boundary  conditions  are  implemented 
as  follows.  A  boundary  node  can  be  either  an  closed  or  an  open  (flow-through)  boundary.  In  the 
former  case,  nothing  is  specified  and  velocity  at  the  node  is  set  to  zero  automatically  in  the  computer 
code.  While  in  the  latter  case,  H,  and  u  of  the  approaching  flow,  with  respect  to  the  characteristic 
ongoing  direction,  must  be  given  at  the  boundary  nodes.  Some  details  are  given  for  both  cases 
below. 


<  Case  1  >  Closed  boundaries:  If  the  closed  boundary  is  located  at  the  downstream  end,  only  sub- 
critical  flow  can  happen  because  the  velocity  is  zero.  Under  this  condition,  one  characteristic  comes 
fi:om  the  outside  of  the  domain  and  the  other  one  is  from  the  inside.  The  equation  associated  with 
the  characteristic  from  outside  will  be  replaced  by  u  =  0,  while  the  other  (either  Eq.  (3.40)  or  (3.41)) 
is  used  for  the  other  characteristic.  On  the  other  hand,  if  the  closed  boundary  is  located  at  the 
upstream  end,  either  sub-critical  or  super-critical  flow  can  occur.  If  the  flow  is  sub-critical,  again, 
the  equation  associated  with  the  characteristic  from  outside  will  be  replaced  by  u  =  0,  while  the  other 
(either  Eq.  (3.40)  or  (3.41))  is  used  for  the  other  characteristic.  If  the  flow  is  super-critical  then  both 
u  and  h  are  set  to  zero. 


<  Case  2  >  Open  boundaries:  In  this  case,  three  types  of  boundary  conditions  can  be  given  for 
sub-critical  flow  when  the  propagation  direction  of  a  characteristic  is  inward  to  the  domain  of 
interest.  They  are  described  as  follows. 


(1)  Given  time-dependent  flow  rate,  Q(t):  (used  for  upstream  open  boundaries) 


n-u 


_Q_  -  Q 

hB,  A 


(3.61) 


(2)  Given  time-dependent  water  stage,  H(,(t):  (used  for  either  upstream  or  downstream  open 
boundaries) 

H  =  Hb  (3.62) 

(3)  Given  rating  water  depth-dependent  flow  rate,  Q(h):  (used  for  natural  downstream  open 
boundaries  only) 
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ll'U 


(3.63) 


_  Q  ,  Q 

hB,  A 

On  the  other  hand,  for  super-critical  flow  either  no  boundary  conditions  is  required  when  the  open 
boundary  is  located  downstream,  or  both  u  and  h  must  be  prescribed  when  the  open  boundary  is 
located  upstream. 

3.1^.  The  Lagrangian  approach  for  both  1-D  diffusion  and  1-D  kinematic  wave  models 

Since  the  kinematic  wave  model  can  be  considered  to  be  a  simplified  form  firom  a 
mathematical  point  of  view,  we  just  demonstrate  how  the  diffusion  wave  equations  are  solved  with 
the  Lagranging  approach  in  the  following.  Its  application  to  solving  the  kinematic  wave  equations 
is  straightforward. 


Recall  Eqs.  (2.1)  and  (2.3) 


dA^dQ 
dt  dx 


Sg+Sjj-Sj+Sj  +S2 


(3.64) 


-1 

R 

p/3  1  a(Zo+h) 

n 

i+(V2y" 

1 

+ 

Eq.  (3.64)  can  be  further  written  as 


ah  ^(uhBJ 

15. - + - 

‘a  dx 


=  Ss+Sr-Sj+Sj+Sj 


(3.65) 


(3.66) 


Substituting  Eq.(3.65)  into  the  second  term  on  the  left  side  of  Eq.  (3.66)  yields 


ahuB, 

dx 


^  dh  .  5B^  .  „  au 
uB, —  +uh — -  +hB, — 
^ax  ax  ^ax 


uB,  +uh 

a 

\ 


aB* 

ah 


+hB, 

a 


2  u  aR  * 

3  R  ah  J 


where 


(3.67) 
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-hB,  R2r. 


1  a2(Zo+h)  hB^  R2/3  1  a(Zo+h)an 


n  [l+(VZ/p(V(Zo+h))^^  ax 2  [l +(VZ/]^  (VZo)^^  5x  ax 


-hB^  R2/3  az,  -1  a(Zo^h) 

n  [l+(VZo)2]^  5x  4  [[  ax 


a(Zo+h)a2(Zo+h) 
ax  ax2 


-hBj  1  1  aCZp +h)  2  p  .j/3  aR  ’ 

n  l+(VZo)2  (V(Zo+h))^'2  5x  3  ax 


-hB^  r2g  a(Zo+h)  -2 
n  (V(Zo+h))i^  ax  3 

Therefore,  Eq.  (3.66)  can  be  written  as 


r  OV?/;  ^^0  '^^0  a* 


aB  •  ,  „  2  u  aR  •  ah 


B.^+  uB  +uh— +hB,- 


3  R  ah  /  ax 


“  '''^R  ~^I '*’^1 '*’^2  ^ 


Eq.  (3.69)  can  be  further  written  as 


B.^.S3*S,-S..S..S,-S 


where  the  following  characteristic  equation  applies. 


„  ,  aB*  ,  2  u  aR* 

uB  +uh - +hB, - 

dx  "  ah  "  3  R  ah 


(3.68) 


(3.69) 


(3.70) 


(3.71) 


Hence  the  solution  to  Eq.  (3.69)  is 

h(x,t)  =  h(X(„0)  +  (Ss+Sjj-Si  +  Sj+S2-S)t 


in  which 


_  u  *  1,0  2  u  aR’ 
t  uB  +uh - +hB, - 

r  "  ah  ^  3  R  ah  . 

■>%  •  / - i - * 

•b 


(3.72) 


(3.73) 


A  nonlinear  iteration  loop  with  the  Picard  method  implemented  is  used  to  solve  Eqs.  (3.7)  and  (3.8) 
in  the  dynamic  wave  model  or  to  solve  Eqs.  (3.64)  and  (3.65)  in  the  difiusion  wave  model  during  each 
time  step. 

3.1.3.  Computation  of  water  budget  at  junctions 

In  the  model,  a  junction  is  considered  to  be  a  reservoir  and  water  budget  is  used  to  determine 
the  water  stage  there.  Thus,  the  governing  equation  to  compute  water  stage  at  a  junction  can  be 
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written  as 


at  1=1 


(3.74) 


where  Vj  is  the  volume  of  water  at  the  junction  [L^];  Qjis  the  flow  rate  associated  with  the  junction’s 
i-th  connected  river/stream  reach  ncr  is  the  number  of  river/stream  reaches  that  is  connected 

to  the  junction.  Since  Vj  can  be  expressed  as  a  function  of  water  depth  at  the  junction,  the  stage  at 
the  junction  can  be  determined  once  Vj  is  computed.  In  our  model,  Eq.  (3.74)  is  solved  implicitly 
(i.e.,  within  the  nonlinear  iteration  loop). 

3.2.  Solving  the  2-D  overland  flow  equations 

3.2.1.  Method  of  characteristics  for  2-D  dynamic  wave  model 


Recall  Eqs.  (2.9)  through  (2.1 1) 


=ss.R-i 

dt  dx  dy 


(3.75) 


‘'X  *'X 


dt  dx  dy  dx  dx  dy  p 


(3.76) 


dvh  duvh  dv^h  d(Z^+h)  dF  dF  t  t 

- + - + -  =  -gh - - - + — —+ — ^+(v'^R-v’I)+-i — - 

dt  dx  dy  dy  dx  dy  p 


(3.77) 


Let  H=h+Zo,  then  Eqs.  (3.75)  through  (3.77)  can  be  written  as  follows  after  mathematical 
manipulation. 


dH  dH  ,  du  dH  ,  dv  ^  dZ^ 

—  +u - +h — +v - +h —  =  (SS+R-I)+u — !i+v - 

dt  dx  dx  dy  dy  dx  dy 


(3.78) 


du  dH  du  du  1  (u  "-u)R-(u ’-u)!  SSu 

- +g - +u - +v -  = - +.i - - - i - 

dt  dx  dx  dy  h[  dx  dy  J  h  hp  h 


(3.79) 


£l+giH+u.^+vi^  ,  (v^-v)R-(v’-v)I  ,  ^y'^y  SSv 


dt  dy  dx  dy  h[  dx  dy  J  h 

Thus,  Eqs.  (3.78)  through  (3.80)  can  be  written  in  matrix  form  as 


dE  .  dE  .  dE  „ 
—  +A^ — +A„ —  =  R 
dt  dx  ^  dy 


where 


(3.80) 


(3.81) 


E  = {H  u  vP 


(3.82) 


Sec3-ll 


u  h  0 

V  0  h 

II 

g  u  0 

0  0  u 

0  V  0 

g  0  V 

and 


R  = 


Ri 

R2 


SS+R-I+u^+v-"""° 


aZp  az, 

lx 


ay 


1 

ap  ap 

XX  yx 

(U^-u)R-(u‘-u)I  ,  ''^x“‘'^x 

_SSu  . 

h 

ax 

ay 

h  hp 

h 

1 

ap  ap 

xy  ^  yy 

^(v"-v)R-(v'-v)I  . 

_SSv 

h 

dx 

ay 

h  hp 

h 

By  using  the  splitting  strategy  mentioned  in  Section  3.1.1,  Eq.  (3.81)  can  be  written  as 

dt 


f  .A.-f  .A,-®  =  RJ.RD 
^  dx  ^  ay 


where 


A,". 


u  0  0 

V  0  0 

0  u  0 

0  V  0 

0  0  u 

0  0  V 

and 


RDj 

1_ 

ap  ap 

XX  ^  ^  yx 

RD  =  ^ 

RDj 

h 

dx  dy 

RD3 

J, 

ap  ap 

xy  yy 

h 

k. 

ax  dy 

RJ  = 


RJj 

RJ2 

RJ, 


y  =  < 


R,-h— -h— 

‘  ax  ay 


R2-RD2-g 


ax 


Eq.  (3.85)  can  be  further  written  as 


DE 

Dt 


R,-RD3-g|i 

ay. 


=  RJ+RD 


(3.83) 


(3.84) 


(3.85) 


(3.86) 


(3.87) 


(3.88) 


(3.89) 
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where 


Let  be  the  solution  of 


we  have,  from  Eq.  (3.89) 


DE  _  dE  ^  .  d  dE  ^  d  dE 
Dt  5t  dx  ^  dy 


—  =  +a/—  =  RJ 

Dt  at  ’‘ax  ^  ay 


E-EP 


=  RJ+RD 


(3.90) 


(3.91) 


(3.92) 


where  Ep  represents  the  Lagrangian  value  of  E.  From  Eq.  (3.91) 

E*-EP 


(3.93) 


Subtracting  Eq.  (3.93)  from  Eq.  (3.92)  yields 


=  RD 


(3.94) 


Based  on  the  above,  we  mean  to  solve  Eq.  (3.93)  for  E*  at  first  and  solve  Eq.  (3.94)  for  E 
based  on  E*.  Eq.  (3.93)  is  to  be  solved  by  the  method  of  characteristics  and  can  be  written,  in  details, 
as  follows. 


Eq.  (3.93)  can  be  written  as 


aE  .  aE  .  aE 

—  +A, —  +A„ —  =  RI 

at  ’‘ax  ^  ay 


where 


(3.95) 


RI  =  (  Rl^f  =  jRj-RDj 
RI3  R3-RD3 


(3.96) 


uk^+vky  hk,  hky 

A-k  =  A^k^+Ayky  =  gk,  uk^+vky  0 

gk^  0  uk^+vkyj 


the  associated  eigenvalues  and  eigenvectors  are 


Aj  =  uk^+vky 


=  {0  ky  -k^}" 


(3.97) 


(3.98) 
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A.2  =  uk^+vk  +v/^ 


e  -IM  ^ 

2  2  2  2 


^3  =  uk^+vky-v/gh 


vih  sK  gk^r 


e  =  S  -  - : 

^  2  2  2 


Now,  we  define 


Thus 


L  =  k.. 


\/ih  y/jh 
2  2 
gk,  gk. 


2 

2 

£!S: 

gky 

^  2 

2 

0 

ky  -k. 

1 

^  h 

Vih 

g  g 

1 

K  K 

g  g 

0 

ky  -k. 

1 

K  ky 

Vih 

g  g 

_ 1__ 

K  K 

[  Vih  g  g 

and  multiply  both  sides  of  Eq.  (3.95)  by  L‘‘.  Thus,  we  obtain 


L-i® +L-^A  LL-‘— +L-^AEL-*—  =  L’^RI 
at  ^  dx  ^  By 


(3.99) 


(3.100) 


(3.101) 


(3.102) 


(3.103) 


(3.104) 


(3.105) 
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u 

gCky 

2 

gcky' 

2 

V 

X 

1 

gck/ 

2 

c 

u+cls 

0 

aw  ^ 
ax 

C 

v+cky 

0 

Ms 

c 

0 

u-cls 

c 

0 

v-cky 

=  L'lRI  (3.106) 


where 


c  =  Vgh 

After  arrangement,  Eq.  (3.106)  can  be  rewritten  as  follows. 


u 

0 

0 

V 

O 

O 

0 

u+ckx 

0 

aw  ^ 
ax 

0 

v+cky  0 

0 

0 

u-ckx 

0 

o 

> 

o 

,  an  ,  an 

V  ^  ax  ay 


+J  hfkk— +kk— -kkf  — ^ 

c[ySax  ay  axj 

— fkk  — +k  k  — -k  k  I 

c  p  "ax  *  ’‘ay  "  ay  ax, 


=  L'lRI 


(3.107) 


(3.108) 


For  a  general  consideration,  we  define  a  new  L  *  which  plays  the  following  transformation. 


aw  =  L‘'aE 


0 

k,™ 

j_ 

kf 

c 

g 

g 

_J_ 

c 

g 

g 

(3.109) 


Multiplying  both  side  of  Eq.  (3.95)  by  this  new  L‘^  and  repeating  mathematical  manipulations 
involved  in  Eqs.  (3.106)  and  (3.108)  yields 
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u  0 


0  u+ck^®  0  0  v+ckf^  0  ^ 

dt  dx  By 

0  0  u-ck^®  0  0  v-cky® 


(Dan,  (1)6H 
'K  ^  dy 


c[^^ax  dy  ^\ay6xjj 

-hf,  (2),  (2) au  .  v(2),  (2) av  (2),  (2)f  au  av )  1 

Tp  ^  H  ^  arJJJ 


=  L-‘RI 


(3.110) 


where 


f  k;^>Ri2-k,"Ri3 

^>1  1  ki^^  k^^' 

_  Iri 

*2  -  j  c  ‘  g  ^  g  ^ 

^3  1  ki^>  k.® 

— RI, +— RIj +-^Rl3 

I  C  ^  g  ^  g  ^ 


Dw,  aw,  aw,  aw, 

- L  =  - i+U - i-+V - - 

Dt  at  ax  ay 


DWj  aw. 


Dt  at 

DWy  _  aWj 

^t  aT 


c[  ax  dy  ^  {  dy  ox  J 

S  =  —  ki^^k,®— +k®ki^^— -ki^^k^f  — +— 1 
^  c  p  ^  ax  *  ^  ay  ^  ^  [  ay  ax  J 


(3.111) 


(3.112) 


(3.113) 


(3.114) 


(3.115) 


(3.116) 


(3.117) 


Note:  Diagonalization  can  be  achieved  under  special  selections  ofkJ^\  and  Ay®  to  make 

zeros  ofSj,  S2,  and  S^. 
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(3.118) 


Eq.  (3.107)  can  be  discretized,  in  time,  as  follows. 


K 


(1) 


m (1)  (1) 


ATj 


Ax 


1  -H;  ^  u”"*  -U2*  ^  ky®  -V2’ 

c  Axj  g  Axj  g  Axj  ^ 


1  K"'  ky® 

egg 


(3.119) 


- 1  H”"‘  -H3*  ^  Iq,®  u“"‘  -U3*  ^  ky®  v""‘  -V3* 

c  AT3  g  Axj  g  Axj 


-1  ky® 

— RI1+— Rl2  +  -^Rl3  (3.120) 

egg 


where  Ui*,  Vj*,  and  Ax,  are  determined  by  backward  tracking  along  the  first  characteristic;  Hj*,  Uj*, 
V2*,  and  At2  are  determined  by  backward  tracking  along  the  second  characteristic;  H3*,  U3*,  V3*,  and 
AX3  are  determined  by  backward  tracking  along  the  third  characteristic;  and 


♦  n+1  n+1  n+1  n+1 

Ui  =  a,Uki  +a2Uk2  +a3U,^  +a4Uk4  +ag 

(3.121) 

Vi*  =  aiv”;‘+a2v^*‘+a3v”"*+a4v”;‘+a7 

(3.122) 

h;  =  biHjr‘^b2Hjr‘+b3Hjr‘+b4H^*^b3 

(3.123) 

*  n+1  1  n+1  1  n+1  1  n+1  v 

«2  =  bjUji  +b2Uj2  +b3Uj3  +b4Uj4  +h^ 

(3.124) 

v;  =  ^V;^^b2Vjr-b3Vjr'+b4V;^^b2 

(3.125) 

h;  =  djH^;^d2ic^d3ic*Ud4ic^d3 

(3.126) 

u;  =  d,<;‘+d2C'^d3c^^d4<:^d, 

(3.127) 

♦  j  n+1  j  n+1  j  n+1  ,  n+1  j 

V3  =  d,V„,  +d2V^  +d3V^  +d4V„4  +(1, 

(3.128) 

in  which  kl,  k2,  k3,  and  k4  are  nodes  of  the  element  that  the  backward  tracking,  along  the  first 
characteristic,  stops  in;  j  1,  j2,  j3,  and  j4  are  nodes  of  the  element  that  the  backward  tracking,  along 
the  second  characteristic,  stops  in;  ml,  m2,  m3,  and  m4  are  nodes  of  the  element  that  the  backward 
tracking,  along  the  third  characteristic,  stops  in.  (see  the  following  figure) 

Note:  1.  Uj  a^bj~  b^,  and  dj  ~  d^  are  within  the  range  of  [0,1  ]. 

2.  We  may  use  two  given  parameters  to  determine  where  to  stop  in  the  backward  tracldng: 
one  is  for  controlling  tracking  time  and  the  other  one  is  for  controlling  tracking  distance. 
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Backward  tracking  along  characteristics  for  2*D  overland  flow 


Ax,  ! 


:h2*,  uj*,  v/) 


u; 


,  m3  — 

^3  i  U3  ,  V3  , 


Figure  3.2.  Tracking  along  characteristics  in  solving  2-D  dynamic  wave  equation. 

Eqs.  (3.1 18)  through  (3.120)  can  be  further  expressed  as 
k<i>,  \  \ 

- — (u-Ui*)-- — (v-Vi')+-^(hK+SS+R-I)u- - (hK  +  SS+R-I)v 

ATj  '  '  ATj  '  '  h  h 

(i)5H  .  (1)311  V,  (DU  "^R-uT  (1)  v''R-v'I  .  (1)  .  (i)  " 
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+  -^(hK  +  SS+R-I)u  +  -^(hK  +  SS+R-I)v---^--— ^ 
gn  gh  c  0x  c  5y 


A2) 


1  (2)  -1  (2) 

1,00  „  ..  A  u^R-u*I  ky  v^R-v'I 


=  -(SS+R-I)  + 
c  g 


g 


(2) 

'y 


t:  h 


g  hp  g  hp  c 

J2) 


^  8y  dx 


)  J 


T-'  SATj'  gAtj' 


cAt. 


A""  U  5Zn  V  5Z„ 

+  -A(hK+SS+R-I)u+-^(hK  +  SS+R-I)v  +  -— +- — ^ 
gn  gh  c  5x  c 

=  -l(ss+R-i)+^^iL:B^+:^ARil!l 

C  g  h  g  h 


.(2) 


g  hp  g  hp  c 


^  du  ^  5v 

,  ay  6xjJ 


(3.130) 


(3.131) 


In  obtaining  Eqs.  (3.129)  through  (3.131),  the  following  relationships  have  been 
employed. 


hp 


KU 


(3.132) 


^  =  KV 


hp 


(3.133) 


yy 


xy  yx 


=  h€„ 

dVL 

XX 

dx 

=  h€^ 

dv 

yy 

dy 

dn  ^ 

d\ 

h-  — 

xy 

dy 

dx 

(3.134) 

(3.135) 

(3.136) 


When  Ui ,  Vj ,  H2 ,  Uj*,  V2*,  H3*  U3*  and  v  3*are  determined  exphcitly  by  using  the  spatial  reach 
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out  option  in  backward  tracking  (i.e.,  track  backward  all  the  way  to  the  previous  time),  Eqs.  (3. 129) 
through  (3.131)  can  be  solved  node  by  node  (H*,  u*,  v*)  as  shown  below. 


Eqs.  (3.129)  through  (3.131),  after  being  multiplied  by  water  depth  (i.e.,  h),  can  be  written 


ai2U+a,3V=b, 


(3.137) 


a2iH+a22U+a23V=b2 


(3.138) 


where 


a3jH+a32U+a33V=b3 


(3.139) 


a, 2  =  ki*^  — +hK+SS+R-I 


(3.140) 


ai3  =  -^+hK+R-I 

ATj 


(3.141) 


T*  T* 


+ky‘^\u  ^R  -u  ‘I)  'R  -  V  ‘I)  +ky<*^— 

P  P 


(3.142) 


(3.143) 


322  =  — ^+-(hK+SS+R-I) 

gAx2  g  c  dx 


(3.144) 


323  =  -^+-(hK+SS+R-I)l---^ 

^  gAT2  g  c  dy 


(3.145) 


^2  =  -r— H2’+— ^U2*+-^V2’+-(SS+R-I)+— (u"R-u‘I)+^(v"R-v‘I) 


cATj  gAXj  gAtj  c 


+  .  ^(2).  (2)dv  .  (2),  (2/ 

g  P  g  P  al  ^  i 


(3.146) 


dy  dx 
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(3.147) 


«  =  k^4_^+l(hK+SS+R-I)l+--^ 

^  [gAT3  g'  '\  C  dx 

=  k<2)  _b_+l(iiK+SS+R-I)  +--^ 
gAXj  g  c  ay 


(3.148) 


(3.149) 


,  hi,(2)  i,i,(2)  ,  ^(2)  ,^(2) 

b,  =  — ^H3%-^U3*+-^V3*--(SS+R-I)  +  — (u"R-u‘l)+-^(v'R-'i 
cAT3  gAX3  gAT3  eg  g 

+ ^  ^  ^  ^  ^  -  ki^  in.  +  .^  1 

gp  gp  c[^^ax^^ay^^iayaxj. 


(3.150) 


Therefore,  we  solve  Eqs.  (3.137)  through  (3.139)  for  H*,  u^  v*  arithmetically.  Now,  we  can 
solve  Eq.  (3.94)  as  follows.  Eq.  (3.94)  can  be  written  in  details  as 

IJ  _LI# 

=  0  (3.151) 


h(u-u*)  ^  ^Fxx  ,  ^Fyx 
At  ax  ay 

h(v-v*)  ^ 

At  ax  ay 


(3.152) 


(3.153) 


Eq.  (3.151)  gives  that  H  =  H*,  while  Eqs.  (3.152)  and  (3.153)  can  be  discretized,  in  the  finite 
element  method,  as 


where 


^[QA]{u}+[QD‘]{u}+[QD'‘]{v}=  {QRM+{BQ‘} 
At 


■[QA]{v}+[QD2]{u}+[QD3]{v}=  {QR2}+{BQ2} 


QAg  =  E  / N^N/dR 


(3.154) 

(3.155) 

(3.156) 


he 

0 

/vn;. 

0 

he 

Re 

xyj 

VNp“dR 


(3.157) 
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vn;- 


0  he,; 

0  0 


•VNp'dR 


0 

0 


•VNp'dR 


QR,'  =  E  /N;^dR 

ceM^  ^  M 

QR,"  =  £  fs:i^dR 

eeM,  J  At 


BQ-  =  E 

e€M.J 


N;n- 


he„  0 
0  he 


xyj 


•Vu+N„ii- 


0  0 

he,,  0 


■Vv 


dB 


(3.158) 

(3.159) 

(3.160) 

(3.161) 

(3.162) 

(3.163) 


0  he,^ 
0  0 


•  Vu+N„V 


he. 


yy 


Vv 


(dB 


(3.164) 


In  solving  Eqs.  (3.129)  through  (3.131)  at  boundary  nodes,  we  demonstrate  how  boundary 
conditions  are  implemented  as  in  the  following.  An  overland  boundary  segmeiit  can  be. either 
closed  or  an  open  (flow-through)  boimdaiy.  In  the  former  case,  nothing  needs  to^^^^.  ^^^lile  in 
the  latter  case,  H,  u,  and  v  of  the  approaching  flow,  with  respect  to  the  characteristic  ongoing 
direction,  must  be  given  at  all  segments  (or  segment  nodes).  Some  details  are  given  for  both  cases. 


<  Case  1>  Closed  boundaries:  The  first  characteristic  equation  is  always  replaced  by  the  following 
equation,  representing  a  zero  normal  flux  on  the  boundary. 

n-u  =  0  (3.165) 

where  n  is  the  outward  unit  normal  vector  of  the  boundary  segment.  Tracking  along  the  closed 
boundary  will  be  used  for  the  second  and  third  characteristics  if  necessary. 


<  Case  2  >  Open  boundaries:  The  first  characteristic  equation  is  always  replaced  by  the  following 
equation,  representing  a  zero  lateral  flux  on  the  boundary. 

0  (3.166) 
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where  is  the  unit  vector  parallel  to  the  segment.  Either  the  second  or  the  third  characteristic 
equation,  depending  on  the  propagation  direction,  will  be  replaced  by  the  boundary  condition 
specified  on  tihe  boundary.  There  are  four  types  of  boundary  conditions  considered  here.  Only  when 
the  propagation  direction  is  inward  to  the  domain  of  interest,  will  the  replacement  be  employed. 

(1)  Given  time-dependent  normal  flux,  q(t):  (used  for  upstream  open  boundaries) 

n-u  =  (3.167) 

n 

(2)  Given  time-dependent  water  stage,  H(t):  (used  for  either  upstream  or  downstream 
boundaries) 

H  =  Hb  (3.168) 

(3)  Given  water  depth-dependent  normal  flux,  q(h):  (used  for  natural  downstream  open 
boundaries  or  river/stream-/junction-related  boundaries) 

n-u  =  ^  (3.169) 

(4)  Given  stage  difference-dependent  normal  flux,  q(AH):  (used  for  river/stream-/junction- 
related  boundaries) 


n*u 


% 

h 


(3.170) 


As  mentioned  earlier  in  Section  3.1.2,  both  depth  and  velocity  must  be  specified  on  the 
boundary  where  super-critical  flow  occurs. 


3.2.2.  The  Lagrangian  approach  for  both  2*D  diffusion  and  2-D  kinematic  wave  models 


Recall  Eqs.  (2.9),  (2.12),  and  (2.13) 

dh  dhu  dhv 
-  + -  + - 

dt  dx  dy 

where 


SS+R-I 


-1 

h 

12/3  1 

d(Zo+h) 

n  1 

j 

1+(VZ^2 

[V(Z^+h)]‘'2 

dx 

-1 

h 

2/3  j 

a(z^+h) 

n 

1+(VZ^2 

[V(Zo+h)]‘^ 

dy 

Substituting  Eqs.  (3.168)  and  (3.169)  into  Eq.  (3.167)  yields 

dt  3  dx  3  dy 


(3.171) 


(3.172) 


(3.173) 


(3.174) 
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where 


_  -1  _ 1  6^(Zo+h)  ^  1  hS/3 _ 1  ^(Zo-*-h)an 

0  [l+(V2y2]^^[V(Zo+h)f'2  dx^  ^n2[i+(VZo)2f'[V(Zo+h)]i"  Qx  dx 

-2  aCZp^h) -1  f  8(Zo^h)V  f 

n  [l+(VZo)2f^  ^  4  il  J  \  ay  J  , 

'■  ^  (3.175) 

a(2o^h)a"(4^h)  ^  a(4+h)a^(2^^fa) 

dx  dx^  3y  5xay 

+ Z?.  ^(2^'^h)  -2  fj  ^  ^y^2l-5/3  ^Zp  a^Zp  ^  5Z|q  a^Zp 

n  [V(Zp+h)]*'^  5x  3  ^  ‘^•1  ax  5x^  9y  dxay 


Y  ^  -1  _ 1  d^(Zo+h)  ^  1  h5/3 _ 1  5(Zo+h)an 

n  [l+(VZo)"f'[V(Zp+h)]‘'2  ay 2  ^n2[i+(VZ,^2f^3[y(2^+h)3i/2  0y  ay 

, -2  acZp^h) -1 1' acZp^h)?  f  (Zp^h)V~''" 

n  [l+(VZp)^f^  3y  4  [(  ax  j  (  ay  J 

(3.176) 

a(Zo H-h)  a^(Zo ^h)  ^  a(2^  +h)  a2(Zo +h) 
dx  dxdy  dy  Qy^ 

+  Zl  a(Zo+h)  _^r  ^  .21-5/3 

n  [V(Zp+h)]‘'^  ay  3  ^  ■•ax  axay  ay  ay^ 

Eq.  (3.174)  can  be  further  written  as 

^  =SS+R-I-X-Y  (3.177) 


where  the  following  characteristic  equations  apply. 


(3.178) 


^  =ly 
dt  3 


Hence  the  solution  to  Eq.  (3.177)  is 

h(x,y,t)  =  h(Xo,yp,0)+(R-I-X-Y)t 


(3.179) 

(3.180) 


in  which 


(3.181) 


y-yo=/|v<it  (3.182) 

A  nonlinear  iteration  loop  with  the  Picard  method  implemented  is  used  to  solve  Eqs.  (3.78) 
through  (3.80)  in  the  dynamic  wave  model  or  to  solve  Eqs.  (3.171)  through  (3.173)  in  the  diffusion 
wave  model  during  each  time  step. 


33.  Solving  the  1-D  river/stream  transport  equations 

In  solving  the  transport  equations  of  both  1-D  river/stream  and  2-D  overland,  the  following 
strategy  is  employed. 


<Stategy>  Using  the  predictor-corrector  scheme  to  deal  with  transport  equations  of  mobile 
materials. 


In  solving  Eqs.  (2.23),  (2.25),  and  (2.26),  the  following  strategy  is  employed.  All  the  three 
equations  can  be  expressed  in  the  following  form. 

A^=UC)+RHS  (3.183) 

where  C  can  be  S„,  C*,  or  L  is  the  diffusion  operator,  and  RHS  represents  source/sink  terms. 
Thus,  we  can  solve  Eq.  (3.183)  with  the  following  two  steps. 

First,  we  solve 

A^  ^  =  L(C^^^”)^(RHS)^  (3.184) 

Second,  we  solve 

=  L(C^^‘”)->-(RHS)^^‘  (3.185) 

We  can  also  subtract  Eq.  (3.185)  by  Eq.  (3.184)  to  yield 

pN+l  _^N  +  l/2 

A^= - ^ -  =  (RHS)''^1-(RHS)N  (3.186) 

The  advantage  of  solving  Eq.  (3.186),  rather  than  Eq.  (3.185),  is  that  we  can  compute 
node  by  node  when  is  previously  determined.  Thus,  we  first  solve  Eq.  (3.184)  for  (the 
intermediate  value)  in  the  so-called  predictor  step  and  perform  the  so-called  corrector  step  by  solving 
Eq.  (3.186)  to  obtain  To  avoid  negative  numerical  results  in  solving  Eq.  (3.184),  the  following 
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equation  is  actually  solved  when  (RHS)^  is  negative. 

At 

Consequently,  we  are  solving  the  following  equation  in  the  corrector  step. 

At  C  ^ 

With  the  finite  element  approximation,  Eq.  (3.184)  can  be  discretized  as  follows. 

'i^+w[QD]]{C}  =  {QR}+(l-w)[QD]{CP}  +  {QB} 

I  At  ) 

where  the  associated  element  matrices  are  defined  as  follows. 

[QA]'  =  ^NjAN-dx 


(3.187) 


(3.188) 


(3.189) 


(3.190) 


,dN:  dN: 


[QD]'  =  f^AK^—^dx 
J  dx  dx 


(3.191) 


{QR}'  =  j‘Ni(RHS)^dx 


(3.192) 


{QBF  =  -  -AK, 


(3.193) 


boundary 


It  is  noted  that  both  [QA]®  and  {QR}'  must  be  lumped  such  that  Eqs.  (3.184)  and  (3.186)  are 
solved  consistently.  Also,  boundary  conditions  for  mobile  materials  are  implemented  in  this 
predictor  step. 

In  the  following,  we  are  to  show  the  procedures  of  solving  the  transport  system  in  Section 

3.3.1,  to  determine  the  concentrations  of  contaminants  and  sediments  at  junctions  in  Section  3.3.2, 
and  to  give  estimation  of  deposition  and  erosion  in  Section  3.3.3. 

33.1.  Procedures  of  solving  1-D  river/stream  transport  equations 

Recall  Eqs.  (2.23)  through  (2.27)  and  express  them  in  the  Lagrangian  form  for  mobile 
materials  as  follows. 


ds„  as„  as„ 

A — =  A — ^+Q— i  =  0 
dt  3t  dx 


(3.194) 
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dS„  d 

dt  dx 


dS„ 
AK  — i 
^  dx 


=  [m;+PR„-PD„+I<']-[SS+R-I+Ri+R2]S„  ne[lJ^J  (3.195) 


For  the  continuity  equation  of  bed  sediment: 

dM„ 

— ^  =  D  -R„ 
dt  “  “ 

For  the  continuity  equation  of  dissolved  chemical: 


ne[l^J 


dc*  ac"  ac" 

A — =  A — !-+Q — -  =  0 

dt  at  ax 


(3.196) 


(3.197) 


a 

A - 

dt  dx 


ac* 

AK — i- 
^  dx 


N. 


Mr^Akt\^Y:  ic  s„acm:  cm„pc^' 

11=1  n=l 


N„ 


m=l 


N. 


n=l 

,  Wvb„i  *in 


n(c,T'-^n(c")*-' 

Cl- 


Ns  N, 

ArA+Alq'^+E  S„Ak^+E  M„Pk^^SS  ^R-I+R^+R^ 

n=l  n=l 

For  the  continuity  equation  of  particulate  chemical  on  suspended  sediment: 

^d(s^  ^  ^a(s„c^)  a(s„c^)  ^  ^ 

dt  at  ax 

For  the  continuity  equation  of  particulate  chemical  on  bed  sediment: 


(3.198) 


ie[l,NJ 


(3.199) 


-  [D.C^R,C^CM.C,’']-[C♦CKc:  ne[l,N.],ie(lJJJ  (3.200) 

We  solve  the  transport  system  by  achieving  the  following  steps. 

Step  1  Solve  Eqs.  (3.194),  (3.197),  and  (3.199)  to  obtain  the  Lagrangian  values  for  suspended 
sediments,  dissolved  chemicals,  and  particulate  chemicals  on  suspend  sediments. 


Step  2  Solve  Eqs.  (3.195)  and  (3.196)  for  S„  and  M„. 


(a)  Solve  Eq.  (3.195)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in  Eq. 
(3.184).  (the  predictor  process  of  Eq.  (3.195))  and  obtain  the  intermediate  value  for  suspended 
sediments. 
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(b)  Prepare  the  corrector  form  of  Eqs.  (3.195)  as  described  in  Eq.  (3.186).  It  can  be  written  as 
follows. 


A 


_(S_^)N.l/2 


6t 


=  (RHS„*)N"^-(RHS;)N  (if(RHS„T^o) 

=  (RHS;)N^>  (if  (RHS„')N<o)  n6[l,NJ 


(3.201) 


where 


(RHS^)  =  [m>PR„-PD„+M“]+[SS+R-I+Rj+R2]S„  nG[l,NJ  (3.202) 

(c)  Solve  Eq.  (3.202)  and  Eq.  (3.196)  node  by  node  with  the  Picard  method  to  obtain  the 
concentrations  of  suspended  and  bed  sediments. 


Note:  In  Eqs.  (3.195)  and  (3.196)  both  D„  and  R„  need  to  be  evaluated  first,  while  in  Eq.  (3.195)  A, 
Q,  P,  R,  I,  R, ,  I^  ,  hf  \  and  are  either  given  or  determined  after  the  flow  equations  are 
solved.  During  each  iteration  in  (c),  both  Eq.  (3.202)  and  (3.196)  are  solved  with  the  time-implicit 
scheme. 


Step^  Solve  Eqs.  (3.198),  (3.200),  and  (3.201)  for  C*,  C^\  and  C^^ 

(a)  Solve  Eqs.  (3.198)  and  (3.200)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as 
described  in  Eq.  (3.184).  (the  predictor  process  of  Eqs.  (3.198)  and  (3.200)). 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.198)  and  (3.200)  described  in  Eq.  (3.186).  They  can  be 
written  as  follows. 


For  dissolved  chemicals: 

(C  W)N+1  w^N+1/2 

A.  ' 

6t 


where 


=  (RHS*)N*1-(RHS*)N  (jf(RHSi'")N^o) 

=  (RHS*)N^'-1^5|^(C*)N*i'2  (if(RHS-)N<o)  ie[i,NJ 

(Cj  ) 


(3.203) 
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n-1  n=l 


-  XjA^Akf^Y.  S„Al4^+5:M„Pk^^SS+R-I+Ri+R2 

n=l  n=l 


u  k5 
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"  E  (a.j  -b„j)CA  n  (C jT”^  ~n  (CjY 

m=l  j=l  j=l 

For  particulate  chemicals  on  suspended  sediments: 


(3.204) 


ie[l.Nl 


=  (RHS^)''*i-(RHS^)''  (if(RHS^)N^o) 


=  (RHS^y 


,N.i  (RHS^)^^s,N. 


^(C_»)N.l/2  (if(RHS^)N<o) 

i) 


where 


(RHS^)  =  [M“+k^'s„AC*+BR„C,'-BD„C^+M=“ 


A+SS+R-I+R 


(3.205) 


ne[l,Nl,  ie[lj^  1 


(3.206) 


ne[l,NJ,  ie[l,NJ 


(c)  Solve  Eqs.  (3.204),  (3.206),  and  (3.201)  node  by  node  with  the  Newton-Raphson  method. 

Note:  In  Eqs.  (3.204),  (3.206),  and  (3.201)  S„  and  M„  are  computed  in  Step  1,  while  A,  Q,  B,  P, 
reaction  rate  constants,  stoichiometry,  1-st  order  decay  constants,  partial  atmospheric  pressure,  and 
sources/sinks  are  either  given  or  determined  after  the  flow  equations  are  solved. 

To  achieve  the  (c)  of  Step  3,  the  following  residual  equations  are  constructed. 

For  dissolved  chemicals: 

(RES;'^) 

=  A[(CiT"‘  -(CiT"‘'^]-6t[(RHS  *)^"‘  -(RHS  *)n]  (if  (RHS  *)N^o) 

r  1  fRl-TS  *1^  /  (3.207) 

=  A(qT^‘-(CiT^‘"  -St  (RHS*)N^i-2 — i_L(c*)N^»«  ^ (rhs."')N<o 

L  J  V  I 


ie[l,Nl 
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For  particulate  chemicals  on  suspended  sediments: 

(RES^) 

=  (if (rhs^)N^o) 


(RHS^) 


,N.i 


S\N 


(c^y 


(C^) 


s^N+l/2 
ni 


(3.208) 

(if(RHS^f<0) 


n6[lJ^J,  i6[l,NJ 

For  particulate  chemicals  on  bed  sediments: 

(RES^")  =  (M„C„y*'-(M„cy-At(RHS,')N^i  ne[l,NJ,  iE[l^J  (3.209) 
The  associated  Jacobian  entries  are  thus  computed  as  shown  in  the  following. 

For  dissolved  chemicals: 


6  (RES*) 


a(c,T^' 


=  6;,A  +  6.,  6t 


Ns 

ArA  +  SS+R-I+Rj  +R2+Alq‘^+£  S„A]4'+£ 

n=l 


Ns 

E 

n=l 


6t 


N„ 


E(a.a-l>.s)A 


m=l 


lCb^(C, *)"“■■•  n  (Cj")'’“^-l^a^(C  *)“-■*  n 


/  J 


(3.210) 


ie[lW 


a(RES*) 


=  -6ii6tk^'’S„A  ne[l,NJ,  ie[l,NJ, 


5(C^)' 


S\N+1 


(3.211) 


a(RES*)  hh 

=  -b,6tk^^M^F 

For  particulate  chemicals  on  suspended  sediments: 

5(RES^)  .  , 

=  -6a6tk^S„A 


d(C,y 


W\N+1 


ne[l,Nl,  i6[l,N] 


ne[l,NJ,  i6[l,NJ 


(3.212) 


(3.213) 


!ES  r  T 

‘  6„AS.-6„6tBD.+6,6ts4iiA+k*AtSS^R-I^R,+R,] 

nl) 


d(Q 


(3.214) 


ne[l,N],  iG[l,Nl 
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a(RES^) 


=  -6;,6tBR 


For  particulate  chemicals  on  bed  sediments: 


ne[ljsri,  ie[l,Nl 


(3.215) 


a(RESj)  ^ 

a(c,T 

a(RES„") 


a(0' 


SxN+1 


=  -6,AtD„ 


ne[im 


ne[im  ie[lj^1 


(3.216) 


(3.217) 


a(RES^ 

^  =  6,M„+6,AtR„^6„AtM„ 


X^+C]  ne[l^J,  ie[l,NJ  (3.2I8) 


33^.  Detemuning  contaminant  and  sediment  concentrations  at  junctions 

At  junctions,  the  following  equations  are  employed  to  determine  the  concentrations  of 
contaminants  and  sediments. 


For  suspended  sediment: 

dV(i)S  (i)  NJRTH(j) 

— =  E  Q'‘Sj‘+M;(j)+M“(j)  +  [R„(j)-D„G)]AJT(j)  ne[l,NJ  (3.219) 
at  k=i 

For  bed  sediment: 

aM„(j) 

=  D„C)-R„(j)  nG[l.NJ  (3.220) 

ot 

For  dissolved  chemical: 
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dva)Q"a) 


dt 


NJRTHO) 


k=l 


+VO)ki‘*[Pi-\c*C)]+Ek;"s„(j)Va)[C^(j)-^C*(j)] 


N. 


k,*  ■  ■  ■  . . 


bf 


k_ 

^LCK(j)AJT(j)[C^(j)-~crQ)] 

i-bb 


n=l 


IC 


+  E(aw-l>M)Cv(j) 


m=l 


n(ci"(i)f“-%n(c,”®h 


For  particulate  chemical  on  suspended  sedimenf : 

dV0)S„G)C^(j) 


dt 


NJRTH(j) 

=  E  Q^s^cf+M^(j)-x:,V0)s^(j)C^(j) 

k=l 


-K\(j)y(})[c^(j)~cr(j)] +R„a)AJTa)c,^a)  -D„o)AJTG)c^(j) 
K 


...  ^ 


ie[l,Nl 


(3.221) 


(3.222) 


ne[l,N3],  ie[l,NJ 


For  particulate  chemical  on  bed  sediment: 

a[M„(j)C,^(j)] 

ft 


-  tD.(j)C^a)-R.®C„'(i))-XM)M.(j)C„^(j)-k“M.a) 


c„‘a)-ii£c’(j) 

C 


(3.223) 


ne[l,N3],ie[l,NJ 

where 

V(j)  =  The  volume  of  water  at  the  j-th  junction  [L^]; 

AJT(j)  =  The  horizontal  area  of  the  j-th  junction  [L^]. 

Dn(j)  =  Deposition  rate  of  the  n-th  size  fraction  sediment  at  the  j-th  junction  [M/L^/T]; 
R^iO)  =  Erosion  rate  of  the  n-th  size  fraction  sediment  [M/L^/T] ; 
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SnO)  *=  Voiumetrically  averaged  sediment  concentration  of  the  n-th  fraction  size  at  the  j-th 
junction  [M/L^]; 

M„(j)  =  Sediment  mass  per  unit  bed  area  of  the  n-th  size  fraction  at  the  j-th  junction  at  the  j-th 

junction  [M/L^]; 

NJRTH(j)  =Number  of  river/stream  reaches  which  connect  to  the  j-th  junction; 

Q'^  =  The  flow  rate  from  the  k-th  connected  river/stream  reach  to  the  junction  P-?/T],  it  is 

positive  if  coming  in  and  negative  if  going  out; 

=  The  concentration  of  the  n-th  sized  suspended  sediment  from  the  k-th  connected 
river/stream  reach  to  the  junction  [M/L^]; 

=  The  concentration  of  the  i-th  dissolved  chemical  from  the  k-th  connected  river/stream 
reach  to  the  junction  [M/L^]; 

=  The  concentration  of  the  i-th  particulate  chemical  on  the  n-th  sized  suspended  sediment 
from  the  k-th  connected  river/stream  reach  to  the  jimction 
M„*(j)  =  Source  of  the  n-th  suspended  sediment  at  the  j-th  junction  [M/T]; 

=  Source  of  the  n-th  suspended  sediment  from  overland  flow  to  the  j-th  junction  [M/T] ; 
Q'^O)  =  Volometrically-averaged  concentration  of  the  i-th  dissolved  chemical  at  the  j-th 

junction  [M/L^]; 

Cni’’0)  =  Volometrically-averaged  particulate  chemical  concentration  on  bed  sediment  of  the  n- 

th  fraction  size  at  the  j-th  junction  [M/M]; 

Cni*(j)  =  Volometrically-averaged  particulate  chemical  concentration  on  suspended  sediment  of 
the  n-th  fraction  size  at  the  j-th  junction  [M/M]; 

Mni“(j)  =  Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size 
at  the  j-th  junction  [M/T]; 

M„i“’‘(j)  =  Source  of  the  i-th  particulate  chemical  on  suspended  sediment  of  the  n-th  fraction  size 

from  overland  to  the  j-th  junction  [M/T]; 

Mi‘^(j)  =  Source  of  the  i-th  dissolved  chemical  at  the  j-th  junction  [M/T]; 

=  Rainfall  source  of  the  i-th  dissolved  chemical  at  the  j-th  junction  [M/T]; 

M.ciw(j)  _  jnfiltration  sink  of  the  i-th  dissolved  chemical  at  the  j-th  junction  [M/T]; 

M.cow(j)  _  Som-ce  of  the  i-th  dissolved  chemical  from  overland  to  the  j-th  junction  [M/T] . 

Eqs.  (3.220)  and  (3.221)  are  solved  first  by  using  the  Picard  method,  while  Eqs.  (3.222)  through 
(3.224)  are  solved  with  the  Newton-Raphson  method. 

333.  Estimation  of  Deposition  and  Erosion 

We  estimate  the  deposition  and  erosion  rates  by  using  the  following  equations. 

<  Case  1  >  Cohesive  sediments  (e.g.,  silt  and  clay): 

D.  =V„S„l-^  (3.224) 

^Dn 
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K  =  — -1 

.  cRn 

(3.225) 

where  is  the  settling  velocity  of  the  n-th  size  fraction  sediment  [L/T];  t  ^is  the  bottom  shear  stress 
or  the  bottom  friction  stress  [M/L/T^];  Tjon  is  the  critical  shear  stress  for  the  deposition  of  the  n-th 
size  fraction  sediment  [M/UT^];  is  the  critical  shear  stress  for  the  erosion  of  the  n-th  size  fraction 

sediment  [M/L/T^];  E„  is  the  erodibility  of  the  n-th  size  fraction  sediment  [M/L^].  In  the  computer 
code,  Vg,,  Tj-dj,  and  are  input  parameters,  while  tb  is  computed  in  the  flow  module. 

<  Case  2  >  Non-cohesive  sediments  (e.g.,  sand): 

-G 

_  sAn  sn 

“  AL 

(3.226) 

G  “G  A 

T)  sn  sAn 

AL 

(3.227) 

where  Gjai,  is  the  actual  load  rate  of  the  n-th  size  fraction  sediment  per  unit  width  at  a  upstream 
location  [M/L/T];  G^n  is  the  maximum  load  rate  (capacity)  of  the  n-th  size  fraction  sediment  per  unit 
width  at  a  downstream  location  [M/L/T];  AL  is  the  distance  between  the  upstream  and  the 
downstream  locations.  In  the  computer  code,  AL  can  be  determined  based  on  the  coordinates,  while 
Gjah  and  Gs„  are  computed  based  on  the  following  equations. 

G  =  S„  +u  *r 

sAn  n 

(3.228) 

p^urS  (t. -T  ) 

G,  =  10 

gd„(P»-P)^ 

(3.229) 

where  p  is  the  fluid  density  [M/L^];  is  the  density  of  the  n-th  size  fraction  sediment  [M/L^];  u  is 
river/stream  flow  velocity  [L/T];  r  is  hydraulic  radius  [L];  S  the  friction  slope,  d^  is  the  median 
diameter  of  the  n-th  size  fraction  sediment  particle  [L];  g  is  gravity  [L/T^];  is  the  critical  bottom 
shear  stress  of  the  n-th  size  fraction  sediment  at  which  sediment  movement  begins  [M/L/T^] .  Among 
these  parameters,  p,  Ps„,  d^,,  and  are  input  by  users,  while  u,  r,  and  S  are  estimated  in  the  flow 
module. 

3.4.  Solving  the  2-D  overland  transport  equations 

The  strategy  for  solving  2-D  overland  transport  equations  has  been  described  in  the  previous 
section  and  will  not  be  repeated  here.  In  the  following,  we  are  to  go  through  the  procedures  of 
solving  the  2-D  transport  system,  like  what  we  have  achieved  in  Section  3.3.1  for  1-D  river/stream 
transport.  Recall  Eqs.  (2.41)  through  (2.45)  and  express  them  in  the  Lagrangian  form  for  mobile 
materials  as  follows. 

For  the  continuity  equation  of  suspended  sediment: 
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(3.230) 


ds„  as„ 

h — ^  =  h — i+q-VS„  =  0 

dt  at  " 


dS 

h-^  -V-[hK-VS„]  =  [m;+R„-dJ-[SS  +R-I]S„ 


For  the  contintiity  equation  of  bed  sediment: 

aM„ 

- ^  =  D  -R„ 

at  “  " 

For  the  continuity  equation  of  dissolved  chemical: 


n€[im 


dc.^  ac* 

h — =  h — i-+q-VCj’'  =  0 

dt  a  ‘ 


dCi  r 

h — !- -V- hK-VC'" 

dt  L  ■  J 


N„ 


m=l 


n(CjT'"~n(CjY 

M  kfj=i 


N. 

I 

n-l 


Mr  .hlq-^p,  k^S.hC^  »£  k“M.C„‘  -M,''’ 


n=l 


xrh  S„hl4' +£  M„k^^SS  +R -I 


n=l 


n=l 


ie[l,Nl 


For  the  continuity  equation  of  particulate  chemical  on  suspended  sediment: 


dt 


a 


h-^^-v|hK-V(S„C^)] 


r  *  +R„C„"  -D„C^]-[A:jh  +SS  ^R  -l]s„C, 


nG[im  ie[l,N  ] 


For  the  continuity  equation  of  particulate  chemical  on  bed  sediment: 

=  [D„C^-R„C„"+kJJXC]-[^^^CKc„"  ne[l,NJ,ie[l,NJ 


(3.231) 


(3.232) 


(3.233) 


(3.234) 


(3.235) 


(3.236) 


(3.237) 
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We  solve  the  transport  system  by  achieving  the  following  steps. 


Step  1  Solve  Eqs.  (3.231),  (3.234),  and  (3.236)  to  obtain  the  Lagrangian  values  for  suspended 
sediments,  dissolved  chemicals,  and  particulate  chemicals  on  suspend  sediments. 

Step  2  Solve  Eqs.  (3.232)  and  (3.233)  for  S„  and  M„. 


(a)  Solve  Eq.  (3.232)  with  all  source/sink  terms  evaluated  at  the  previous  time,  as  described  in  Eq. 
(3.184).  (the  predictor  process  of  Eq.  (3.232))  and  obtain  the  intermediate  value  for  suspended 
sediments. 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.232)  as  described  in  Eq.  (3.186).  It  can  be  written  as 
follows. 


h 


-(SjN.l/2 


6t 


where 


=  (RHS;)N*^  -(RHS;)N  (if  (RHS„')N^o) 

=  (RHS„*)N^‘  -  (RHS;)''<o)  ne[l,NJ 


(3.238) 


(RHS^)  = 


-ISS.R-I]S„ 


ne[l,NJ 


(3.239) 


(c)  Solve  Eq.  (3.239)  and  Eq.  (3.233)  node  by  node  with  the  Picard  method  to  obtain  the  solutions 
for  suspended  and  bed  sediments. 

Note:  In  Eqs.  (3.232)  and  (3.233)  both  D„  and  R„  need  to  be  evaluated  first,  while  in  Eq.  (3.232)  K, 
h,  R,  I,  and  SS  are  either  given  or  determined  after  the  flow  equations  are  solved.  During  each 
iteration  in  (c),  both  Eq.  (3.239)  and  (3.233)  are  solved  with  the  time-implicit  scheme. 

Step  3  Solve  Eqs.  (3.235),  (3.237),  and  (3.238)  for  C^,  C^^  and  C^^ 

(a)  Solve  Eqs.  (3.235)  and  (3.237)  with  aU  source/sink  terms  evaluated  at  the  previous  time,  as 
described  in  Eq.  (3.184).  (the  predictor  process  of  Eqs.  (3.235)  and  (3.237)). 

(b)  Prepare  the  corrector  form  of  Eqs.  (3.235)  and  (3.237)  described  in  Eq.  (3.186).  They  can  be 
written  as  follows. 

For  dissolved  chemicals: 
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(CW)N.l_(cW)N.l/2 


where 


=  (RHS  -(RHSi'*')^  (if  (RHSi'*')N^o) 


=  (if  (RHS  *)N<0 )  ie[l,N  1 


N,  ,  kf  N, 

TT  ✓y-i  Wxb„i  "m  T1 


(RHS-)  -  E  (a^-b„piCl>n(CjT''-^n(Cj'')‘ 

m=l  j=l  k^j  j=l 


(3.240) 


Ns  N, 

V  '  i.sbo  1.  s  .  \  '  1.  bbi  I  /-I  b  ,  ■»  jr  ciw  ciw 


+ Mr +5:  ki’s^hc^ 


Ns  N, 

\Wi  .  i-i.af  .  o  -ui-sf  ,  X  -Kjf  i,bf 


-  Arh+hlq^+i:S„hl4^5:M„k“^SS+R-I  C,'^  i6[lJ^J 


(3.241) 


"or  particulate  chemicals  on  suspended  sediments: 


(S„C^)N^1-(S„C^)N^''2 


(RHS^)''*‘-(RHS^)N  (if(RHS^)N^o) 


=  (RHS^y 


N.i  (RHS^)’ 


(3.242) 


m^(C_S)N.i/2  (if(RHS^)N<o)  ne[l,N3],  ie[l,NJ 


where 


(RHS^)  =  [M“+k^'hS„C*+R„C^'-D„C^]-[A:ih+k*h  +  SS+R-l]s„C„ 


ne[lJ^J,  ie[l,NJ 


(3.243) 


(c)  Solve  Eqs.  (3.241),  (3.243),  and  (3.238)  node  by  node  with  the  Newton-Raphson  method. 

Note:  In  Eqs.  (3.235),  (3.237),  and  (3.238)  S„  and  M„  are  computed  in  Step  1,  while  h,  K,  reaction 
rate  constants,  stoichiometry,  1-st  order  decay  constants,  partial  atmospheric  pressure,  and 
sources/sinks  are  either  given  or  determined  after  the  flow  equations  are  solved. 

To  achieve  the  (c)  of  Step  3,  the  following  residual  equations  are  constructed. 

For  dissolved  chemicals: 
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(RESi'^) 


=  h[(CiT*‘  -(CiT^''']-6t[(RHSiT'  -(RHS  *)n]  (if  (RHS^'f  ^o) 

=  h[(CiT^'  -(qT^'''l-6t  (RHS  .(RgSi  w  n.i/2  (jf  (RHS  *)N<0  { 
L  J  \  I 


(3.244) 


ie[lJ4J 


on  suspendec 


(RES^) 


=  h[(S„C^f -(S„C^)N*i«1-6t  (RHS^)N^'  (if  (RHS^)N<0 

(CS)N 


3.245) 


ne[lJ^J,  ie[l.NJ 


For  particulate  chemicals  on  bed  sediments: 


(RES„")  =  (M„C„V*i-(M„C„V-At(RHS^V^i  n6[l,NJ,  ie[l,NJ  (3.246) 
The  associated  Jacobian  elements  are  thus  computed  as  shown  in  the  following. 

For  dissolved  chemicals: 


6(RES*) 

a(CiT^' 


6,h+6,6t  Arh+SS+R-I+hki^+X:  S„hk^+EM„k^'  - 


N„  I  N,  N,  \  1  (3.247) 

St  E(a^-bjh  n  (q*)‘’“^-k^a^(Cr)‘^'^  11  (Cj"^ 


ie[lJSfl 


0(RESi'") 

dic^r*^ 

0(RES='')  bb 

—  '  =  -SaStCM, 

For  particulate  chemicals  on  suspended  sediments: 


ne[l,NJ,  ie[l,NJ, 


ne[l,Nl,  iG[l,Nl 


(3.248) 


(3.249) 
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a(REs^) 

a(c,T^* 


ne[l,NJ,  ie[l,NJ 


a(RES^) 


=  6iihS„ +6,  6t  D„  +6,  6t  S„  +l4'’h  +SS  +R  -I 


ne[l,NJ,  ie[l,NJ 


a(RES^) 


-6,6tR„ 


For  particulate  chemicals  on  bed  sediments: 


a(RES„') 

a(c,T^' 


-6,Atk,X 


ie[l,NJ 


ne[l,NJ,  ie[l^J 


g(RES„") 


-6,AtD„ 


ne[l,NJ,  ie[l,NJ 


a(RES,^) 


=  6,M„+6,AtR„+6,AtM„ 


Ab  t  bb 

m+Kn 


ne[l,NJ,  ie[l,NJ 


(3.250) 

(3.251) 

(3.252) 

(3.253) 

(3.254) 

(3.255) 
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4.  EXAMPLES 


In  this  section,  we  present  the  application  of  our  model  to  solving  a  number  of  examples 
concerning  (1)  1-D  river/stream  flow,  (2)  2-D  overland  flow,  (3)  1-D  river/stream  transport,  (4)  2-D 
overland  transport,  (5)  1-D  liver/stieam  flow  and  transport,  (6)  2-D  overland  flow  and  transport,  (7) 
1-D/2-D  flow,  and  (8)  1-D/2-D  flow  and  transport.  Unless  specifically  announced,  the  diffusion 
wave  model  is  solved  when  the  simulation  of  water  flow  is  involved  in  those  examples. 


4.1.  Examples  of  1-D  river/stream  flow 

4.1.1.  Example  1  of  1-D  river/stream  flow 

In  this  example,  a  horizontally  200  m-long  river/stream  containing  a  uniform  width  of  2  m 
is  considered.  The  bottom  elevation  of  the  river/stream  is  shown  in  Figure  4.1.  Manning’s 
roughness  is  0.015.  Initially,  it  is  dry  everywhere.  As  the  simulation  starts,  a  uniform  rainfall  of  10'^ 
m/s  covers  the  entire  domain  of  interest.  At  the  upstream  boundary  node  (i.e.,  X  =  0  m)  water  depth 
is  set  at  10'*®  m,  while  at  the  downstream  boundary  node  (i.e.,  X  =  200  m)  a  water  depth-dependent 
flow  rate  boundary  condition  is  applied.  No  infiltration  is  considered  in  this  example.  The  domain 
is  discretized  with  twenty  elements,  10  m  long  for  each.  A  one-hour  simulation  is  performed  with 
a  fixed  time  step  size  of  2  seconds.  A  relative  error  of  lO"^  is  used  to  determine  convergence  for  the 
nonlinear  loop. 


Figure  4.1.  The  bottom  elevation  of  Example  1  of  1-D  river/stream  flow. 


Figures  4.2  and  4.3  plot  water  depth  and  discharge,  respectively,  at  time  =  100  s,  200  s,  300 
s,  600  s,  and  1200  s.  Since  the  change  of  water  depth  is  almost  unobservable  after  time  =  1200  s, 
a  steady  state  is  presumed  to  have  reached  thereafter  under  a  uniform  rainfall  of  10'*  m/s.  From 
Figure  4.2,  a  hydraulic  jump  is  observed  from  X  =  50  m  to  X  =  60  m  due  to  the  slope  change  from 
-0.2  to  -  0.001.  In  each  constant  slope  region  (i.e.,  X  =  0  to  50  m,  X  =  50  to  150  m,  and  X  =  150  to 
200  m),  water  depth  has  the  tendency  to  increase  gradually  along  the  downslope  direction  because 
of  a  constant  rainfall  over  the  entire  domain.  We  can  also  observe  backwater  effect  in  the  region 
close  to  the  downstream  outlet  (X  =  170  to  200  m).  In  Figure  4.3,  Discharge  is  computed  by 
multiplying  flow  velocity  with  cross-sectional  area  which  is  water  depth-dependent. 


Sec4-1 
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gradually  along  the  downslope  direction  because  of  a  constant  rainfall  over  the  entire  domain.  We  can  also 
observe  backwater  effect  in  the  region  close  to  the  downstream  outlet  (X  =  170  to  200  m).  In  Figure  4.3, 
Discharge  is  computed  by  multiplying  flow  velocity  with  cross-sectional  area  which  is  water  depth-dependent. 


Figure  4.2.  Water  depth  at  various  times  for  Example  1  of  1-D  river/stream  flow. 


Figure  4.3.  Discharge  at  various  times  for  Example  1  of  1-D  river/stream  flow. 


4.1.2.  Example  2  of  1-D  river/stream  flow 

This  example  simulates  water  flow  in  a  river/stieam  network  system.  The  system  is  composed  of  three 
river/stream  reaches  that  are  connected  through  a  junction  (Figure  4.4).  Each  reach  is  100  m  long  and  is 
discretized  with  1 1  nodes  and  10  elements:  Nodes  1  through  1 1  for  Reach  1, 12  through  22  for  Reach  2,  and 
23  through  33  for  Reach  3.  Nodes  11,  12,  and  33  coincide  with  one  another  and  are  located  at  the  junction. 
The  junction  covers  the  area  between  Nodes  10  and  11,  Nodes  12  and  13,  and  Nodes  32  and  33. 
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1 


Figure  4.4.  River/stream  network  for  Example  2  of  1-D 
river/stream  flow. 

Reaches  1  and  3  have  a  uniform  river/stream  width  of  2  m  and  the  slope  of  their  bottom  elevation  is 
-0.2  along  the  downstream  direction,  while  Reach  2  contains  a  uniform  river/stream  width  of  3  m  and  the  slope 
of  its  bottom  elevation  is  -0.1.  Manning’s  roughness  is  0.02  for  all  three  reaches.  Initially,  it  is  dry 
eveiywhere.  As  the  simulation  starts,  a  uniform  rainfall  of  10'^  m/s  is  put  on  Reach  1.  At  Node  1  water  depth 
is  kept  at  0  m,  while  a  constant  flow  of  2x10'^  mVs  flows  through  Node  23  through  the  simulation  and  a  water 
depth-dependent  flow  rate  boundary  condition  is  applied  at  the  downstream  boundary  node  (i.e..  Node  22). 
No  infiltration  is  considered  in  this  example.  A  one-hour  simulation  is  performed  with  a  fixed  time  step  size 
of  2  seconds.  A  relative  error  of  lO"^  is  used  to  determine  convergence  for  the  nonlinear  loop. 

Figures  4.5  through  4.7  plots  water  depth  at  various  times  for  Reaches  1  through  3,  respectively. 
Since  rainfall  and  upstream  boundary  conditions  do  not  vary  with  time,  a  steady  state  is  observed  after  time 
=  600  s.  It  is  noted  that  the  downstream  node  of  Reach  1  (i.e.,  at  X  =  100  m  in  Figure  4.5),  the  upstream  node 
of  Reach  2  (i.e.,  at  X  =  0  m  in  Figure  4.6)  and  the  downstream  node  of  Reach  3  (i.e.,  at  X  =  100  m  in  Figure 
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4.7)  coincide  with  one  another  and  are  where  the  junction  is.  One  can  verify  this  by  checking  the  water  depths 
at  these  locations.  We  can  see  the  inarching  of  wet  fronts  in  both  Figures  4.6  and  4.7  and  an  increasing  depth 
along  the  downstream  direction  in  Figure  4.5  due  to  a  constant  uniform  rainfall. 

For  die  1-st  reach 


Figure  4.5.  Water  depth  of  Reach  1  at  various  times  for  Example  2  of  1-D  river/stieam  flow. 


For  the  2-iid  reach 


Figure  4.6.  Water  depth  of  Reach  2  at  various  times  for  Example  2  of  1-D  river/stream  flow. 


For  die  3-id  reach 


Figure  4.7.  Water  depth  of  Reach  3  at  various  times  for  Example  2  of  1-D  river/stream  flow. 
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4.2.  Example  of  2-D  overland  flow 

Two  examples  are  presented  in  this  subsection.  Example  1  is  to  show  the  application  of 
using  the  diffusion  wave  model  to  handle  an  overland  system  which  contains  the  slope  of  bottom 
elevation  ranging  from  0.01  to  0.5;  Because  of  the  steep  slope  involved,  the  d5Tiamic  model  is 
difficult  to  solve  with  any  numerical  scheme,  even  with  the  most  physically  natural  method  of 
characteristics.  Example  2  is  a  standing  wave  problem  to  demonstrate  the  capability  of  the  method 
of  characteristics  to  accurately  solve  the  dynamic  wave  model  when  the  slope  is  small.  Difficulty 
is  encountered  in  dealing  with  water  flow  over  steep  slope  overland  system  by  solving  the  dynamic 
wave  model.  On  the  other  hand,  the  diffusion  wave  model  cannot  provide  accurate  solution  when 
the  inertia  tenns  are  important,  such  as  flow  on  a  flat  region.  Thus,  it  is  desirable  to  develop  a  hybrid 
model  in  which  an  adaptive  scheme  can  be  built  to  automatically  select  appropriate  models 
(kinematic,  diffusion,  or  dynamic  wave  models)  for  different  regions  of  the  entire  watershed. 

4.2.1.  Example  1  of  2-D  overland  flow 

The  domain  of  interest  coveres  a  horizontal  area  of  200  m  x  80  m.  The  bottom  elevation 
contour  is  given  in  Figure  4.8.  The  domain  is  discretized  with  320  triangular  elements  (Figure  4.9). 
Manning’s  roughness  is  0.04.  Initially,  it  is  dry  everywhere.  A  two-hour  simulation  is  performed 
with  a  fixed  time  step  size  of  5  seconds.  A  relative  error  of  10"^  is  used  to  determine  convergence 
for  the  nonlinear  loop.  As  the  simulation  starts,  a  uniform  rainfall  of  m/s  covers  the  entire 
domain  of  interest  for  the  first  half  hour  and  1.5x10  *  m/s  for  the  third  half  hour.  As  for  the  second 
and  the  fourth  half  hours,  the  rainfall  rate  is  zero.  On  the  upstream  boundary  side  (i.e.,  X  =  0  m) 
water  depth  is  set  at  10'^”  m  through  the  simulation,  while  on  the  downstream  boundary  side  (i.e., 
X  =  200  m)  a  water  depth-dependent  flux  boundary  condition  is  applied.  The  boundaries  of  Y  =  0 
m  and  80  m  are  impermeable.  No  infiltration  is  considered  in  this  example. 

Figure  4.10  plots  water  depth  at  various  times  from  the  simulation.  From  the  figure,  we  can 
first  see  the  irregular  depth  distribution  due  to  the  slope  change  of  ground  surface  (Figure  4.8).  Since 
the  water  depths  at  Time  =  600  s,  1200  s,  and  1800  s  can  not  be  distinguished,  we  may  say  a  steady 
state  has  reached  by  Time  =  600  s  under  a  rainfall  of  10  *  m/s.  Likewise,  the  depths  at  the  end  of  the 
second  and  the  fourth  half  hours  (i.e..  Time  =  3600  s  and  7200  s,  respectively)  tells  us  the  steady 
state  for  the  two  non-rainfall  period  of  times  have  reached  by  then. 
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Bottom  Elevation  [m] 


Figure  4.8.  The  contour  of  bottom  elevation  for  Example  1  of  2-D  overland  flow. 


Bottom  Elevation  [m] 


Figure  4.9.  Discretization  for  Example  1  of  2-D  overland  flow. 
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Water  Deptti  [m],  Hme  =  600  s 
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Figure  4.10.  Water  depth  at  various  times  for  Example  1  of  2-D  overland  flow. 
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4^.2.  Example  2  of  2-D  overiand  flow 

A  1-D  standing  wave  problem  is  considered  in  this  example.  It  is  solved  by  2-D  method  of 
characteristics,  as  presented  in  Section  3.2.1.  This  problem  is  governed  by  the  wave  equations  as  follows. 


dt^  ^  dx^ 


(4.1) 


^ 

dt^  dx^ 


(4.2) 


=  gh 


where  u  is  the  velocity  along  the  1-D  direction  [L/T];  c  is  the  wave  speed  [L/T];  h  is  water  depth  [L];  tj  is  stage 
deviation  [L];  g  is  gravity  [L/T^].  The  domain  of  interest  is  200  m  long  in  the  x-direction  and  50  m  wide  in 
the  y-direction.  It  is  discretized  with  20  elements:  10  m  x  50  m  each.  The  boundary  end  of  X  =  200  m  is 
closed,  while  the  other  one  at  X  =  0  m  is  open  and  the  water  stage  is  forced  up  and  down  according  to 

^lx=on.  =  ^sm—  (4.4) 

Thus,  we  set  u  =  0  m/s  at  X  =  200  m  to  settle  the  boundary  condition  for  achieving  the  simulation. 
The  analytical  solution  of  this  problem  can  be  found  as  follows  [Wang  and  Connor,  1975]. 


a^c  .  271 

— - - sm  — 

[v/5 


1  cos- 


a  Ini  X  il  ♦  2nt 

^ - cos  —  - -  1  sm -  m 

cos^  [^/3l  200  jj  200  (4.6) 

A  simulation  of  400  seconds  is  performed,  where  time  step  size  is  set  to  2.5  seconds.  The  initial 
condition  is  given  at  t  =  50  s  according  to  Eqs.  (4.5)  and  (4.6).  Figures  4.1 1  and  4.12  show  the  comparison 
of  water  depth  and  velocity,  respectively,  between  analytical  solution  and  computed  results  at  various  times. 
The  comparison  simply  tells  that  the  method  of  characteristics  can  solve  the  dynamic  wave  model  quite 
accurately. 
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4.3.  Example  of  1-D  river/stream  transport 

This  example  is  to  demonstrate  the  capability  of  the  model  in  simulating  both  contaminant  and 
sediment  transport.  A  horizontally  200  m-long  river/stream  containing  a  uniform  width  of  2  m  is  considered. 
To  focus  on  transport,  we  assume  water  depth  is  2  m  and  river/stream  velocity  is  1  m/s  throughout  the 
river/stream.  Three  dissolved  chemicals  are  considered  to  undergo  the  following  reaction. 

^  +  C2  ^  C3  kf  =  0.002,  kj,  =  0.005  (4.7) 

where  Cl  ,  C2  ,  and  C3  represent  dissolved  chemicals. 

Three  sizes  of  sediments  are  taken  into  account  and  are  considered  to  be  cohesive  sediments.  The 
settling  speeds  are  1.2xl0’*  m/s  for  Sediment  1,  l.SxlO"^  m/s  for  Sediment  2,  and  4.5x10'^  m/s  for  Sediment 


3.  The  critical  shear  stresses  for  deposition  and  erosion  are  2.75  g/m/s^ 
three  sediments.  The  foUowdng  sorption  reactions  are  included. 

and  2.68  g/m/s^,  respectively,  for  all 

^  ^  P^  +  ^ 

kf  =  0.001, 

k,  =  0.0 

(4.8) 

+  SS2  PS2  +  SS2 

kf  =  0.001, 

11 

O 

b 

(4.9) 

CC  +  ^  PS3  +  SS3 

II 

O 

8 

II 

o 

b 

(4.10) 

CC  +  BSl  PBl  +  BSl 

kf  =  0.0001, 

II 

o 

b 

(4.11) 

CC  +  BS2  PB2  +  BS2 

II 

P 

r 

II 

o 

b 

(4.12) 

CC  +  BS3  ^  PB3  +  BS3 

kj  =  0.0001, 

II 

o 

b 

(4.13) 

where  CC  can  be  Cl  ,  C2  ,  or  C3  ;  SSI  ,  SS2  ,  and  SS3  are  suspended  sediments;  BSl  , 

BS2  ,  and  BS3  are  bed  sediments;  PSl  ,  PS2  ,  and  PS3  are  particulate  chemicals  on  suspended 
sediments  associated  with  CC  ;  PBl  ,  PB2  ,  and  PB3  are  particulate  chemicals  on  bed  sediments 
associated  vdth  CC  .  We  have,  therefore,  18  sorption  reactions  in  total. 

Initially,  only  bed  sediments  exist  in  the  domain  of  interest.  The  initial  concentration  is  50  g/m^  for 
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boundary  conditions  are  applied  to  the  upstream  boundary  node  (i.e.,  X  =  0  m),  where  all  dissolved  chemicals 
have  a  constant  concentration  of  1  g/m^  and  all  other  mobile  materials  have  zero  concentration  at  this  boundary 
node.  The  longitudinal  dispersivity  is  0.01  m.  A  1000  second  simulation  is  performed  with  a  fixed  time  step 
size  of  2  seconds.  A  relative  error  of  lO"^  is  used  to  determine  convergence  for  both  linear  and  nonlinear 
iterations  involved  in  the  computation. 

Figures  4.13  through  4.17  plot  the  numerical  results  at  various  time,  including  concentration 
distributions  for  (1)  dissolved  chemicals  (Figure  4.13),  (2)  suspended  sediments  (Figure  4.14),  (3)  bed 
sediments  (Figure  4.15),  (4)  particulate  chemicals  on  suspended  sediments  (Figure  4.16),  and  (5)  particulate 
chemicals  on  bed  sediments  (Figure  4.17).  Since  the  first  and  second  dissolved  chemicals  are  involved  in 
identical  reactions,  their  concentration  distributions  are  identical  to  each  other,  so  do  those  of  their  related 
particulate  chemicals. 

Figure  4.13  shows  a  decreasing  dissolved  chemical  concentration  for  all  three  dissolved  chemicals. 
This  is  because  we  allow  the  adsorption  to  happen,  but  do  not  allow  desorption  from  particulate  chemicals  to 
dissolved  chemicals  (see  Eqs.  (4.8)  through  (4.13)).  Figure  4.14  shows  the  trend  of  increasing  concentration 
of  suspended  sediment  along  the  downstream  direction,  while  Figure  4.15  depict  the  decrease  of  bed  sediment 
with  the  increase  of  time.  Figures  4.14  and  4.15  tell  that  the  deposition  is  less  than  the  erosion  under  the 
condition  set  for  this  example.  Figures  4.16  and  4.17  also  help  verify  this.  Since  the  dissolved  chemicals  are 
little  in  the  downstream  region,  the  major  source  of  chemicals  are  the  particulate  chemicals  on  suspended 
sediments  that  are  transported  from  the  upstream  region  along  with  water.  Because  erosion  is  greater  than 
deposition,  we  can  hardly  find  particulate  chemicals  on  bed  sediments  in  the  downstream  region  (Figure  4. 17). 
On  the  other  hand,  we  observe  an  increase  of  particulate  chemical  on  suspended  sediments  along  the 
downstream  direction  (Figure  4.16).  By  comparing  the  numerical  results  at  various  times,  it  seems  that  the 
concentration  distributions  (Figures  4.13, 4.14,  and  4.16)  are  approaching  a  steady  state.  This  tendency  will 
continue  until  the  bed  sediments  are  completely  depleted,  starting  from  the  upstream  end. 
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(a) 


(b) 


(c) 


Figure  4.15.  Concentrations  of  (a)  the  first,  (b)  the  second,  and  (c)  the  third 
bed  sediments  for  the  example  of  1-D  river/stream  transport. 
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(a) 


(b) 


(c) 


Figure  4.17.  Concentrations  of  the  first  particulate  chemical  on  (a)  the  first,  (b)  the  second, 
and  (c)  the  third  bed  sediments  for  the  example  of  1-D  river/stream  transport. 
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4.4.  Example  of  2-D  overland  transport 

The  domain  of  interest  has  covered  a  horizontal  area  of  200  m  x  70  m  and  is  discretized  with  140 
rectangular  elements:  10  m  x  10  m  for  each  element.  To  deal  with  transport  only,  water  depth  is  set  to  1  m  and 
the  velocity  is  -1.0  m/s  in  the  x-direction  and  0.0  m/s  in  the  y-direction  everywhere.  The  following  chemical 
reactions  are  embraced. 


Cl 

+  C2  ^  C4 

o 

o 

ii 

kb  =  0.005 

(4.14) 

cT 

+  «  C5 

kf  =  0.01, 

kb  =  0.0025 

(4.15) 

C2 

+  2«  C6 

kf  =  0.01, 

kb  =  0.001 

(4.16) 

where  Cl  ,  C2  ,  C3  ,  C4  ,  C5  ,and  C6  are  dissolved  chemicals. 

Initially,  there  is  no  dissolved  chemical  anywhere  in  the  domain.  A  600  second  simulation  is 
performed  with  a  fixed  time  step  size  of  10  seconds.  A  relative  error  of  lO"^  is  used  to  determine  convergence 
for  the  nonlinear  loop.  As  the  simulation  starts,  a  Dirichlet  concentration  of  1  g/m^  is  applied  for  Cl  ,  C2  , 
and  C3  on  the  upstream  boundary  (i.e.,  X  =  200  m)  between  Y  =  30  m  and  40  m.  The  boundaries  of  Y  = 
0  m  and  70  m  are  impervious.  The  longitudinal  and  transverse  dispersivities  are  0.5  m  and  0.1  m,  respectively. 
The  diffusion  coefficient  is  10'^  mVs. 

Figures  4.18  through  4.23  show  the  numerical  result  at  time  =  260  s.  A  steady  state  result  is 
considered  to  have  reached  after  260  s.  The  maximum  concentrations  of  C4  ,  C5  ,  and  C6  are  0.26286 
g/m^  0.25637  g/m^  and  0.16833  g/m^  respectively,  which  are  found  in  the  middle  of  downstream  area  (i.e., 
X  =  40  to  50  m  and  Y  =  30  to  40  m) 

Concentration  contour  of  Cl  after  time  =  260 


Figure  4. 18.  Concentration  contour  of  the  first  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 
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Concentration  contour  of  C2  after  time  =  260 


Figure  4. 19.  Concentration  contour  of  the  second  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 

Concentration  contour  of  C3  after  time  =  260 


Figure  4.20.  Concentration  contour  of  the  third  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 

Concentration  contour  of  C4  after  time  =  260 


Figure  4.21.  Concentration  contour  of  the  fourth  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 
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Concentration  contour  of  C5  after  time  =  260 


Figure  4.22.  Concentration  contour  of  the  fifth  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 

Concentration  contour  of  C6  after  time  =  260 


Figure  4.23.  Concentration  contour  of  the  sixth  dissolved  chemical  at  time  =  260  s 
for  the  example  of  2-D  overland  transport. 


4^.  Example  of  1-D  river/stream  flow  and  transport 

In  this  example,  a  horizontally  200  m-long  river/stream  containing  a  uniform  width  of  2  m  is 
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considered.  The  bottom  elevation  of  the  river/stream  is  shown  in  Figure  4.1.  Manning’s  roughness  is  0.015. 
hiitially,  it  is  dry  everywhere.  The  chemical  reactions  considered  are  identical  to  those  in  the  example  of  2-D 
transport  (Eqs.  (4.14)  through  (4.16)).  As  the  simulation  starts,  a  uniform  rainfall  of  10'^  m/s  covers  the  entire 
domain  of  interest,  which  contains  the  first  three  chemicals  (i.e..  Cl  ,  C2  ,and  C3  )oflg/m^  At  the 
upstream  boundary  node  (i.e.,  X  =  0  m)  water  depth  is  kept  at  10‘'°  m  and  the  concentrations  are  kept  at  1  g/m^ 
for  Cl  ,  C2  ,  C3  andat0g/m3for  C4  ,  C5  ,  C6  .  At  the  downstream  boundary  node  (i.e.,X  =  200 
m)  a  water  depth-dependent  flow  rate  boundary  condition  is  employed  for  flow  and  a  variable  boundary 
condition  is  applied  for  transport.  Infiltration  is  neglected.  The  domain  is  discretized  with  twenty  elements, 
10  m  long  for  each.  A  one-hour  simulation  is  performed  with  a  fixed  time  step  size  of  2  seconds.  A  relative 
error  of  10"*  is  used  to  determine  convergence  for  required  iteration  in  both  flow  and  transport  computations. 

Figure  4.24  depicts  water  depth  at  various  times  for  the  simulation.  It  is  the  same  as  Figure  4.2 
because  they  have  an  identical  setup  for  the  flow  simulation  and  we  assume  the  flow  is  not  influenced  by 
transport  in  our  model.  Figures  4.25  through  4.31  show  the  concentration  distributions  at  various  times  for 
the  first  through  the  sixth  dissolved  chemicals,  respectively.  It  is  seen  that  the  third  dissolved  chemicals  are 
consumed  most  among  the  three  reactant  chemicals  that  consumes  most  in  this  example  (Figures  4.25  through 
4.27).  This  is  because  all  three  reactions  contain  the  same  forward  reaction  rate  constant  (Eqs.  (4.16)  through 
(4.18))  but  the  third  reaction  has  the  smallest  backward  reaction  rate  constant  and  the  third  dissolved  chemical 
has  a  stoichiometric  coefficient  of  2  as  a  reactant  chemical  in  the  third  reaction  (Eq.  (4.16)). 


•  WMS1D.T1IIE*  100.00 
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Figure  4.24.  Water  depth  at  various  times  for  the  example  of  1-D  river/stream  flow  and  transport. 
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Figure  4.25.  Concentration  of  the  first  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.26.  Concentration  of  the  second  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.27.  Concentration  of  the  third  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 
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Figure  4.28.  Concentration  of  the  fourth  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.29.  Concentration  of  the  fifth  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 


Figure  4.30.  Concentration  of  the  sixth  dissolved  chemical  at  various  times 
for  the  example  of  1-D  river/stream  flow  and  transport. 
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4.6.  Example  of  2-D  overland  flow  and  transport 

The  setup  for  the  flow  simulation  in  this  example  is  the  same  as  that  in  the  example  of  2-D  flow 
(Section  4.2)  except  that  time  step  size  is  2.5  s  for  this  example.  The  same  chemical  system  as  described  in 
both  Sections  4.4  and  4.5  is  also  considered  here.  Initially,  it  is  dry  and  there  is  no  chemical  in  the  domain  of 
interest.  As  the  simulations  starts,  Dirichlet  boundary  conditions  are  applied  on  the  upstream  boundary  (i.e., 
X  =  0  m)  for  the  transport  simulation,  where  the  concentrations  of  Cl  ,  C2  ,  C3  are  maintained  at  1  g/m^ 
and  those  of  C4  ,  C5  ,  C6  areatOg/m^ 

Figures  4.31  through  4.37  plot  the  numerical  results  at  various  times.  Figure  4.31  is  actually 
representing  the  same  computational  result  as  Figure  4. 10  for  Example  1  of  2-D  overland  flow  in  Section  4.2.1. 
This  is  again  because  this  example  has  a  simulation  setup  identical  to  that  of  the  example  in  Section  4.2. 1  and 
the  feedback  from  transport  to  flow  is  not  considered  in  the  model.  Although  the  results  shown  in  Figures  4.32 
through  4.37  are  difficult  to  analyze,  we  can  observe  the  same  concentration  distribution  trends  from  upstream 
to  downstream  for  the  six  dissolved  chemicals  as  those  shown  in  Figures  4.25  through  4.30.  Additionally,  it 
is  consistent  that  C3  and  C6  are  the  chemicals  having  the  smallest  concentration  among  (he  three  reactant 
chemicals  and  the  three  product  chemicals,  respectively,  in  the  downstream  region. 
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Water  Depth  [m],  Time  =  600  s  Water  Depth  [m],  Time  =  1200  s 


Concentration  of  C2  [g/m^],  Time  =  600  s  Concentration  of  C2  [gW],  Time  =  1200  s 


Figure  4.33.  Concentration  of  the  second  dissolved  chemical  at  various  times 
for  the  example  of  2-D  overland  flow  and  transport. 


Concentration  of  C3  [gW],  Time  =  600  s  Concentration  of  C3  Time  =  1200  s 


Figure  4.34. 


Concentration  of  C4  [gW],  Time  =  600  s  Concentration  of  C4  [gW],  Time  =  1200  s 


Concentration 


Concentration  of  C5  [gW],  Time  =  600  s  Concentration  of  C5  [g/m^],  Time  =  1200  s 


Concentration 


Concentration  of  C6  [g/m^],  Time  =  600  s  Concentration  of  C6  [g/m^],  Time  =  1200  s 


Concentration 


4.7.  Example  of  1-D/2-D  flow 

A  flow  system  including  both  1-D  river/stream  and  2-D  overland  is  considered  in  this  section.  The 
topography  and  discretization  of  the  system  is  plotted  in  Figure  4.38.  As  shown  in  the  figure,  water  would 
flow  from  overland  into  the  river/stream  that  is  located  in  the  middle  of  the  system  (i.e.,  the  blue  strip)  and  then 
leave  the  system  through  the  downstream  outlet  of  the  river/stream  (i.e.,  at  X  =  0  m,  Y  =  0  m).  The  slope  of 
river/stream  bottom  elevation  is  0.02. 

The  river/stream  width  increases  along  river/stream’s  downstream  direction:  10  m  at  Y  =  100  and  90 
m,  12  m  at  Y  =  80  and  70  m,  14  m  at  Y  =  60  and  50  m,  16  m  at  Y  =  40  and  30  m,  18  m  at  Y  =  20  and  10  m, 
and  20  m  at  the  outlet  (i.e.,  Y  =  0  m).  The  width  changes  linearly  between  any  two  consecutive  locations 
mentioned  above.  The  system  is  initially  dry.  A  variable  rainfall  is  applied  to  the  system  during  a  two-hour 
simulation,  which  is  5x10'^  m/s  during  the  first  twenty  minutes,  1x10  ®  m/s  between  20  and  40  minutes,  2x10'® 
m/s  between  40  and  60  minutes,  no  rainfall  between  60  and  80  minutes,  4x10'®  m/s  between  80  and  100 
minutes,  and  5x10  ’  m/s  for  the  last  twenty  minutes  of  the  simulation.  A  constant  water  depth  of  0  m  is  set  at 
the  ridge  top  of  the  system  during  the  simulation.  A  water  depth-dependent  flux  boundary  condition  is 
employed  on  the  interface  between  2-D  overland  and  1-D  river/stream  to  determine  the  injection  of  water  from 
overland  to  river/stream.  Impermeable  boundary  condition  is  employed  for  the  overland  boundary  at  Y  =  0 
m  (X  =  -400  to  -10  m  and  X  =  10  to  400  m).  The  upstream  end  of  the  river/stream  is  treated  as  a  Junction, 
where  water  budget  is  used  to  determine  the  water  depth  there.  A  water  depth-dependent  flow  rate  boundary 
condition  is  used  to  compute  the  water  going  out  from  the  river/stream  downstream  boundary,  which  is  also 
the  only  outlet  of  the  system.  The  time  step  size  for  2-D  overland  flow  computation  is  20  seconds  and  it  is  2 
seconds  for  calculating  1-D  river/stream  flow  (i.e.,  1  2-D  time  step  =  10  1-D  time  steps). 

Figures  4.39  and  4.40  plot  water  depth  and  velocity,  respectively,  at  various  times  for  1-D  river/stream. 
Figure  4.41  depicts  the  contour  of  water  depth  at  various  times  for  2-D  overland.  From  Figure  4.39,  we  can 
easily  observe  the  back  water  effect  due  to  the  depth-dependent  flow  rate  at  the  outlet  of  1-D  river/stream. 
Also,  we  see  that  the  junction  (at  X  =  0  m  in  Figures  3.39  and  3.40)  collects  water  from  the  converging 
overland  flow  and  has  the  largest  water  depth  in  the  river/stream.  This  seems  contradictory  to  our  intuition. 
However,  such  a  result  is  the  consequence  of  the  widening  of  river  width  from  upstream  to  downstream  and 
a  relatively  flat  river  bottom.  Figure  4.41  illustrates  how  water  depth  changes  with  rainfall  rates  in  the 
overland  domain.  We  can  also  observe  the  back  water  effect  due  to  the  depth-dependent  normal  flux  given 
on  the  river/stream-  and  junction-related  downstream  boundary  (i.e.,  the  1-D/2-D  interface  boundary). 
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Time  =  1200  s 


if  l-D  river/stream  at  various  times  for  the  example  of  1-D/2-D  flow. 


Time  =  600  s  2  r  Time  =  1200  s 


Velocity  of  1-D  river/stream  at  various  times  for  the  example  of  1-D/2-D  flow. 


WaterDepth[m],  Time  =  600  s  Water  Depth  [m],  Time  =  1200  s  Water  Depth  [m],  Time  =  2400  s  Water  Depth  [m],  Time  =  3600 


Figure  4.41 .  Water  depth  of  2-D  overland  at  various  times  for  the  example  of  1-D/2-D  flow. 


4.8.  Example  of  1-D/2-D  flow  and  transport 

This  example  considers  both  flow  and  transport  in  1-D  river/stream  and  2-D  overland.  The  topography 
and  grids  are  shown  in  Figure  4.42  where  flow  is  driven  into  the  river/stream  from  the  overland  simply  due 
to  gravity.  The  slope  of  river  bottom  elevation  is  0.01. 

The  river/stream  has  a  uniform  width  of  10  m.  The  system  is  initially  dry.  A  variable  rainfall  is 
applied  to  the  system  during  a  two-hour  simulation,  which  is  10'^  m/s  during  the  first  twenty  minutes,  2x10"^ 
m/s  between  20  and  40  minutes,  10'^  m/s  between  40  and  60  minutes,  2x10'^  m/s  between  60  and  80  minutes, 
10'®  m/s  between  80  and  100  minutes,  and  no  rainfall  for  the  last  twenty  minutes  of  the  simulation.  A  constant 
water  depth  of  lO"^  m  is  set  at  the  ridge  top  of  the  system  during  the  simulation.  A  water  depth-dependent  flux 
boundary  condition  is  employed  on  the  interface  between  2-D  overland  and  1-D  river/stream  to  determine  the 
injection  of  water  from  overland  to  river/stream.  Impermeable  boundary  condition  is  employed  for  the 
overland  boundary  at  Y  =  0  m  and  Y  =  900  m  (X  =  200  to  595  m  and  X  =  605  to  1000  m).  Water  depth  is 
maintained  at  10'^  m  at  the  upstream  end  of  the  river/stream.  A  water  depth-dependent  flow  rate  boundary 
condition  is  used  to  compute  the  water  going  out  from  the  river/stream  downstream  boundary.  Manning’s 
roughness  is  0.01  for  overland  and  0.03  for  river/stream.  The  time  step  size  for  2-D  overland  flow  computation 
is  10  seconds  and  it  is  2  seconds  for  calculating  1-D  river/stream  flow. 

As  for  the  transport  simulation,  six  dissolved  chemicals  and  two  reactions  are  taken  into  account. 
Among  the  six  chemicals,  five  of  them  are  involved  in  the  two  reactions  as  described  in  the  following  and  the 
other  one  is  non-reactive. 


Cl 

IS  1 

IS  1 

kf  =  0.01, 

K 

=  0.005 

(1) 

Cl 

+  C3  ^  C5 

II 

o 

b 

K 

=  0.005 

(2) 

The  dissolved  chemical  C5  is  radioactive  and  the  decay  constant  is  10"^  1/s.  Cl  ,  C2  ,  C3  , 
and  C6  exist  in  rainfall  with  a  constant  concentration  of  1  g/m^.  In  2-D  overland  transport.  Variable 
boundary  conditions  are  applied  on  both  the  upstream  boundary  (i.e.,  ridge  top),  where  the  concentration  is 
1  g/m^  for  C 1  ,  C2  ,  C3  ,  and  C6  ,  and  is  0  g/m  %r  the  other  two  chemicals  if  the  flow  is  directed  into 
the  domain  of  interest.  For  the  overland-river  interface,  we  also  apply  variable  boundary  conditions  by  using 
the  respective  concentrations  in  the  channel  as  the  incoming  concentrations  when  the  flow  is  directed  from 
river/stream  to  overland  on  the  interface  boundary.  As  for  1-D  river/stream  transport,  the  same  variable 
boundary  condition  as  is  employed  for  the  overland  ridge  top  is  applied  to  both  the  upstream  and  the 
downstream  boundary  nodes  (i.e.,  located  at  (600  m,  900  m)  and  (600  m,  0  m),  respectively). 

Figures  4.43  and  4.44  plot  water  depth  at  various  times  for  1-D  river/stream  and  2-D  overland. 
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respectively.  Figures  4.45  through  4.50  depict  the  concentration  of  the  first  through  the  sixth  dissolved 
chemicals,  respectively,  at  various  times  for  1-D  transport.  Figures  4.51  through  4.56  show  the  concentration 
of  the  first  through  the  sixth  dissolved  chemicals,  respectively,  at  various  times  for  2-D  overland. 

Both  Figures  4.43  and  4.44  indicate  that  steady  state  have  been  reached  by  the  end  of  each  constant 
rainfall  period  of  time  (each  rainfall  period  lasts  for  twenty  minutes).  For  both  1-D  and  2-D  flows,  the  back 
water  effect  is  obvious.  The  reason  has  been  given  in  the  previous  example.  Figures  4.50  and  4.56  show  the 
uniformly  distributed  concentration  of  the  nonreactive  dissolved  chemical  in  1-D  and  2-D,  respectively.  This 
numerical  result  help  to  verify  our  model  when  1-D  flow,  2-D  flow,  1-D  transport,  and  2-D  transport  are  all 
taken  into  account. 

Since  the  second  and  the  third  dissolved  chemicals  are  involved  in  identical  aqueous  complexation 
reactions,  they  should  have  the  same  concentration  distribution,  so  should  their  respective  product  chemicals 
(i.e.,  the  fourth  and  the  fifth  chemicals,  respectively).  However,  the  radioactive  nature  of  the  fifth  chemical 
makes  the  difference  between  them  as  well  as  the  difference  between  their  respect  product  chemicals.  On  the 
other  hand,  the  decay  is  so  slow  so  that  the  difference  mentioned  above  is  almost  invisible  (compare  Figures 
4.46  with  4.47,  Figures  4.48  with  4.49,  Figures  4.52  with  4.53,  and  Figures  4.54  with  4.55). 
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Time  =  1200  s  Time  =  2400  s 


X  [m]  X  (tn] 

•e  4.45.  Concentration  of  the  first  dissolved  chemical  in  1-D  river/stream  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Time  =  2400  s 
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Time  =  2400  s 


Time  =  1 200  s  Time  =  2400  s 


for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  Cl  [fi/ra^],  Time  =  1200  s  Concentration  of  Cl  [g/m^],  Time  =  2400  s  Concentration  of  Cl  [g/m%  Time  =  3600  s 


Concentration  of  the  first  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  C2  [gW],  Time  =  1200  s  Concentration  of  C2  [g/m^],  Time  =  2400  s  Concentration  of  C2  [g/m^],  Time  =  3600  s 


•e  4.52. 


Concentation  of  O  [g/m’],  Time  =  1200  s  Concentration  of  C3  [g/m’],  Time  =  2400  s  Concentration  of  C3  [g/m  ],  Time  =  3600  s 


Concentration  of  the  third  dissolved  chemical  in  2-D  overland  at  various  times 
for  the  example  of  1-D/2-D  flow  and  transport. 


Concentration  of  C4  [g/m^],  Time  =  1200  s  Concentration  of  C4  [g/m^],  Time  =  2400  s  Concentration  of  C4  [g/m^],  Time  =  3600  s 


Concentration  of  C6  [g/m^],  Time  =  1200  s  Concentration  of  C6  [gW],  Time  =  2400  s  Concentration  of  C6  [g/m’],  Time  =  3600  s 


5  SUMMARY  AND  CONTINUING  WORK 


A  numerical  model  has  been  developed  to  simulate  water  flow  and  sediment  and  reactive 
chemical  transport  in  watershed  systems.  The  mathematical  basis  and  numerical  approaches  of  the 
model  are  given  in  Sections  2  and  3.  Section  4  has  demonstrated  that  the  model  was  able  to  deal  with 
various  configurations  of  problems  involving  flow  and  sediment  and  chemical  transport  over 
watersheds  with  a  "wide  range  of  ground  surface  slopes.  Eight  example  problems  were  presented  to 
illustrate  the  basic  capability  of  the  model. 

Much  experience  has  been  gained  throughout  the  research  of  this  project.  It  was 
demonstrated  that  the  method  of  characteristics  can  provide  accurate  numerical  simulations  in  solving 
dynamic  wave  model  when  the  slopes  of  ground  surface  are  small.  However,  its  application  to 
solving  problems  with  steep  slopes  has  proved  elusive.  On  the  other  hand,  the  Lagrangian  approach 
was  illustrated  to  be  robust  in  solving  difiusion  and  kinematic  wave  models.  However,  kinematic  and 
diffusion  wave  models  can  yield  accurate  solutions  only  for  cases  of  mild  to  steep  slope  problems. 
For  cases  of  problems  involving  small  slopes,  the  Idnematic/diffusion  wave  models  could  not  generate 
accurate  results,  even  though  the  models  can  be  solved  easily.  The  kinematic  wave  model  cannot 
even  address  the  effects  of  backwater  on  flow  dynamics  over  watersheds.  In  consideration  of 
robustness  (i.e.,  easy  to  solve  with  numerical  methods)  and  accuracies,  a  hybrid  model  to  adaptively 
choosing  appropriate  models  (kinematic,  diffusion,  or  dynamic  wave  models)  for  different  regions  of 
a  watershed  is  much  desirable. 

Using  the  predictor-corrector  approach  to  solving  the  transport  equations,  we  have  made  the 
computation  effective  and  robust.  For  each  time,  we  need  to  solve  the  advection/dispersion  transport 
only  one  time  in  the  predictor  step,  and  the  chemical  reaction  system  can  be  solved  node  by  node  in 
the  corrector  step.  The  reaction  chemistry  can  be  quite  general.  All  reactions  whose  rates  can  be 
described  by  the  collision  theory  are  included  in  the  model. 

Continuing  work  is  in  progress  to  couple  the  watershed  model  with  a  three-dimensional 
subsurface  flow  and  chemical  transport  model. 
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APPENDIX  A  DATA  INPUT  GUIDE 


This  data  input  guide  is  composed  of  eight  files:  three  for  2-D  overland  flow/transport,  three 
for  1-D  river/stream  flow/transport,  one  for  contaminant/sediment  information  and  one  for  1-D/2-D 
mapping.  They  are  described  as  follows. 


2‘D  Overland  Geometry  Fde  (.2dm  files  for  2-D  overland  simulations) 


T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

GE  Card 

Element  information 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

GE 

Card  group  identifier. 

C3 

IC3 

Identification  of  element. 

3 

A  triangular  element  is  being  input. 

4 

A  quadrilateral  element  is  being  input. 

1 

M 

+ 

id  of  global  element. 

2 

IE1(M,1) 

+ 

The  index  of  node  number  1  of  the  M  element. 

3 

IE2(M,2) 

The  index  of  node  number  2  of  the  M  element. 

4 

IE2(M,3) 

+ 

The  index  of  node  number  3  of  the  M  element. 

5 

ffi2(M,4) 

+ 

The  index  of  node  number  4  of  the  M  element.  It  is  zero  for  a 

triangular  element. 

6 

1E2(M,5) 

+ 

id  of  the  material  type  of  the  M  element. 

GNCard 

Node  information 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

GN 

Card  group  identifier. 

C3 

IC3 

blank 

1 

N 

+ 

id  of  global  node.. 

2 

X2(N,1) 

+ 

The  x-coordinate  of  the  global  node. 

3 

X2(N,2) 

+ 

The  y-coordinate  of  the  global  node. 

4 

X2(N,3) 

+ 

The  z-coordinate  (bottom  elevation)  of  the  global  node. 

ENCard 

End  of  data  control 

Field 

Variable 

Value  Description 

Cl-2 

ICl 

EN 

Card  group  identifier. 

C3 

IC3 

D 

End  of  input  data. 

2-D  Overland  Flow  File  (.2bc  files  for  2-D  overland  simulations) 

T1-T3  Cards  Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 
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OP  Card  Run  option  parameters 


Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

1 

Simulation  selection. 

1 

KMOD 

0 

Index  of  river/stream  simulation. 

No  river/stream  simulation. 

1 

Only  flow  is  simulated. 

2 

Both  flow  and  transport  are  simulated. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

2 

Solver  specification. 

1 

ILUMP 

0 

Index  of  using  mass  lumping. 

No  mass  lumping. 

1 

Mass  lumping. 

2 

PNTS 

1 

Index  of  using  linear  matrix  solver  for  flow  simulations. 

The  pointwise  iterative  matrix  solver. 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial). 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUAR 

1 

Index  of  using  quadrature  for  numerical  integration. 

Nodal  quadrature  for  line  element  integration. 

2 

Gaussian  quadrature  for  line  element  integration. 

4 

IDIFF 

1 

Index  of  taking  into  accotmt  the  eddy  viscosity  terms. 

Yes. 

0 

No,  the  eddy  viscosity  terms  are  neglected. 

5 

lALLOW 

1 

Index  of  allowing  the  simulation  to  continue  when  there  is  no 
convergence  reached  for  the  non-linear  iteration. 

Yes. 

0 

No. 

6 

MODEL 

3 

Index  of  simulating  overland  flow. 

Using  MOC  to  solve  the  dynamic  model  only. 

2 

Using  the  diffusion  model  only. 

1 

Using  the  kinematic  model  only. 

0 

Using  the  hybrid  model . 

-10 

Specifying  water  depth  and  flow  velocity  with  the  initial  condition. 
The  flow  equation  is  not  solved. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

3 

Weighting  factor  for  simulations. 

1 

W 

0.5 

Time  derivative  weighting  factor  for  flow  simulation. 
Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OME 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 
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O.O-l.OUnder  relaxation. 

1.0  Exact  relaxation. 

1.0-2.00ver  relaxation. 

3  OMI  Relaxation  parameter  for  solving  linearized  matrix  equation. 

O.O-l.OUnder  relaxation. 

1.0  Exact  relaxation. 

1.0-2.00ver  relaxation. 


Fi?ld 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

lEIGEN 

0 

GG  will  not  be  read. 

1 

GG  will  be  read. 

2 

GG 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient  matrix 
used  in  the  Preconditioned  Conjugate  Gradient  method. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

5 

Method  of  characteristics. 

1 

ISK 

-1 

Index  of  choosing  the  directions  of  characteristics. 

Using  the  velocity  direction  as  the  direction  of  characteristics. 

0 

Solve  the  diagonalization  equations  for  the  directions. 

1 

Specify  directions  by  users. 

2 

ANGLEl 

+ 

User  specified  angle  for  the  direction  of  the  first  characteristic. 

( COS(ANGLEl),  SIN(ANGLEl))  is  the  direction. 

3 

ANGLE2 

+ 

User  specified  direction  for  the  second  and  third  characteristics. 

(COS(ANGLE2),  SIN(ANGLE2))  is  the  direction. 


IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IP 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

NNITER 

+ 

Allowed  number  for  the  non-linear  iteration  in  the  flow  simulation. 

2 

NPITER 

+ 

Allowed  number  for  the  linearized  iteration  in  the  flow  simulation. 

3 

TOLBH 

+ 

Allowed  relative  error  for  water  depth. 

4 

TOLBV 

+ 

Allowed  relative  error  for  velocity  components. 

5 

V_CUT 

+ 

Cut-off  of  velocity.  If  the  computed  velocity  is  smaller  than  this  value, 
it  is  set  to  zero. 

6 

FMSR 

+ 

Multiplication  factor  to  set  the  allowed  mean  square  root  errors, 
BHMSR  for  water  depth  and  BVMSR  for  velocity,  where  BHMSR 
=  TOLBH*FMSR;  BVMSR  =  TOLBV*FMSR. 

PTCard 

Time  marching  pqrameter$ 

Field 

Variable 

Value  De^criptipn 
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C  1-2 

ICl 

PT 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

NXW 

+ 

Subelement  number  in  one  direction  that  is  used  in  the  “in-element” 
particle  tracking.  The  total  subelement  number  included  in  one  global 
element  is  NXW*NXW. 

2 

IDETQ 

1 

Index  of  particle  tracking  approach. 

Using  the  average-velocity  approach. 

2 

Using  the  constant- velocity  approach. 

TC  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

TC 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

TMAX 

+ 

Maximum  simulation  time.  [T] 

2 

DELT 

+ 

Initial  time  step  size.  [T] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

TC 

Card  group  identifier. 

C3 

IC3 

2 

Computational  time  step. 

1 

IDTXY 

+ 

Index  of  xy  series  for  variable  time  step. 

OC  Card 

Output  control  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OC 

Card  group  identifier. 

C3 

IC3 

1 

Print  control  parameters. 

1 

IBUG 

0 

Do  not  print  the  diagnostic  output. 

1 

Do  print  the  diagnostic  output. 

2 

JOPT 

0 

Print  at  specified  intervals. 

1 

Print  at  specified  set  of  time  values. 

3 

KPRT 

+ 

Specify  the  interval  if  JOPT  =  0. 

NPRINT 

+ 

Specify  total  number  of  the  specified  times,  if  JOPT=l. 

Note: 

NPRINT  new  lines  after  OCl  card  are  needed  if  JOPT  =  1. 

(the  first  new  line) 

1 

TPRT(l) 

+ 

The  1-st  specified  time  that  the  simulation  results  are  to  be  printed. 

(the  second  new  line) 

1 

TPRT(2) 

+ 

The  2-nd  specified  time  that  the  simulation  results  are  to  be  printed. 

(the  NPRINT  new  line) 

1 

TPRT(NPRINT)  + 

The  NPRINT-th  specified  time  that  the  associated  simulation  results 

are  to  be  printed. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OC 

Card  group  identifier 
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C3  ICS 

2 

Print  options. 

1  NSELT 

+ 

Total  options  to  be  selected. 

2  KPRO(i) 

Print  options. 

1 

Print  water  depth. 

2 

Print  velocity. 

3 

Print  infiltration  rate. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C3  ICS 

3 

Output  control  for  post-process. 

1  IHLE 

0 

Save  as  ascii  format. 

1 

Save  as  binary  format. 

2  KOPT 

0 

Save  at  specified  interval. 

1 

Save  at  specified  set  of  times. 

3  KDSK 

+ 

Save  every  specified  interval,  if  KOPT=0. 

NPOST 

+ 

Save  at  specified  set  of  times,  if  KOPT=l. 

Npte:  NPOST  new  lines  after  OC3  card  are  needed  if  KOPT  =  1. 

(the  first  new  line) 

1  TSV(l) 

(the  second  new  line) 

+ 

The  1-st  specified  time  that  the  simulation  results  are  to  be  saved. 

1  TSV(2) 

+ 

The  2-nd  specified  time  that  the  simulation  results  are  to  be  saved. 

(the  NPOST  new  line) 

1  TSV(NPOST)  + 

The  NPOST-th  specified  time  that  the  simulation  results  are  to  be 
saved. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C3  ICS 

4 

Solution  file  output  options. 

1  KSELT 

+ 

Total  options  to  be  selected. 

2  KSAVE(i) 

Save  options. 

1 

Save  water  depth. 

2 

Save  flux. 

3 

Save  infiltration  rate. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C  3  ICS 

5 

Print  options  for  1-D  groundwater  flow. 

1  NCOLUM 

+ 

Total  vertical  column  to  be  printed. 

Note:  NCOLUM  new  lines  after  OC5  card  are  needed. 

(the  first  new  line) 

1  ICL(1) 

+ 

The  1-st  specified  vertical  column  that  the  groundwater  flow  are 

to  be  printed. 
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(the  second  new  line) 


1  ICL(2) 

+ 

The  2-nd  specified  vertical  column  that  the  groundwater  flow  are  to 
be  printed. 

(the  NPRINT  new  line) 

1  ICL(NCOLUM)  + 

The  NCOLUM-th  specified  vertical  column  that  the  groundwater  flow 
are  to  be  printed. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C3  ICS 

6 

Print  1-D  groundwater  model  options 

1  NSELTG 

+ 

Total  options  to  be  selected. 

2  KPRG(i) 

Print  options. 

1 

Print  pressure  head. 

2 

Print  water  contents. 

3 

Print  velocity. 

GCCard 

Cross  section  parameters 

Value 

Description 

Cl-2  ICl 

GC 

Card  group  identifier. 

C3  ICS 

1 

Generate  cross  section  to  calculate  discharge. 

1  NGCL 

+ 

Total  number  of  cross  sections. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

GC 

Card  group  identifier. 

C3  ICS 

2 

Cross  section  information. 

1  id 

+ 

hidex  number  of  cross  section. 

2  NPL 

+ 

Number  of  nodal  points  in  the  x-section. 

(new  line) 

+ 

Node  points. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

GC 

Card  group  identifier. 

C3  ICS 

3 

Save  and  print  hydrograph. 

1  LOPT 

0 

Save  and  print  at  specified  interval. 

1 

Save  and  print  at  specified  set  of  times. 

2  LDSK 

0 

Save  and  print  at  specified  interval. 

+ 

Save  and  print  every  specified  interval,  if  LOPT=0. 

LPOST 

+ 

Save  and  print  at  specified  set  of  times,  if  LOPT=l. 

Note:  LPOST  new  lines  after  GC3  card  are  needed  if  LOPT  =  1 . 

(the  first  new  line) 

1  TSA(l)  +  The  1-st  specified  time  that  the  hydrographs  are  to  be  saved, 

(the  second  new  line) 

1  TSA(2)  +  The  2-nd  specified  time  that  the  hydrographs  are  to  be  saved. 
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(the  NPOST  new  line) 


1 

TSA(LPOST)  + 

The  LPOST-th  specified  time  that  the  hydrographs  are  to  be  saved. 

(new  line) 

+ 

After  GC3  card,  specify  the  times,  if  LOPT  =  1.  One  data  entry  per 

line. 

MP  Card 

Material  property  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

MP 

Card  group  identifier. 

C3 

IC3 

1 

Material  property. 

1 

i 

+ 

id  of  material  type. 

2 

PROP(l,i) 

+ 

Manning’s  roughness  associated  with  the  material  type. 

3 

PROP(2,i) 

+ 

xx-eddy  viscosity  associated  with  the  material  type.  [L^/T] 

4 

PROP(3,i) 

+ 

yy-eddy  viscosity  associated  with  the  material  type.  [L^/T] 

5 

PROP(4,i) 

+ 

xy-eddy  viscosity  associated  with  the  material  type.  [L^/T] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

MP 

Card  group  identifier. 

C3 

IC3 

2 

Density  of  water  and  acceleration  of  gravity. 

1 

rruNTT 

1 

Index  of  time  unit. 

The  time  unit  for  simulation  is  second. 

2 

The  time  unit  for  simulation  is  minute. 

3 

The  time  unit  for  simulation  is  hour. 

2 

ILUNTT 

1 

Index  of  length  unit. 

The  length  unit  for  simulation  is  meter. 

2 

The  length  unit  for  simulation  is  foot. 

3 

The  length  unit  for  simulation  is  kilometer. 

4 

The  length  unit  for  simulation  is  mile. 

3 

RHO 

+ 

Density  of  water,  (M/L^). 

SPCard 

Soil  property  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

SP 

Card  group  identifier. 

C3 

IC3 

1 

Index  for  computing  the  infiltration. 

1 

KSP 

0 

Index  of  infiltration  rate. 

Input  the  infiltration  rate. 

1 

Computed  by  1-D  vertical  groundwater  model. 

RFCard 

Rainfall  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

RF 

Card  group  identifier. 

C3 

IC3 

1 

Rainfall  data  for  the  simulation. 

1 

i 

+ 

id  of  global  element. 

2 

IRTYP(i) 

+ 

Index  of  the  rainfall  rate  XY  series  for  the  element. 
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SS  Card  Source/sink  parameters 


Field 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

1 

Source/sink  data  for  the  simulation. 

1 

i 

-1- 

id  of  global  node. 

2 

ISR(i) 

+ 

Index  of  the  source/sink  rate  XY  series  for  the  node. 

IN  Card 

Infiltration  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IN 

Card  group  identifier. 

C3 

IC3 

1 

Input  for  Infiltration  data. 

1 

i 

-1- 

id  of  global  node. 

2 

ROUTND(i) 

+ 

Input  infiltration  rate  for  the  node.  [ITT] 

OB  Card 

Open  boundary  parameters 

Field 

Variable 

Value  Description 

C  1-2 

ICl 

OB 

Card  group  identifier. 

C3 

IC3 

1 

Dirichlet  boundary  nodes  for  the  simulation. 

1 

NPDB(j) 

+ 

id  of  global  node  corresponding  to  the  j-th  Dirichlet  boundary  node. 

2 

IDTYPG) 

+ 

id  of  xy  series  to  describe  the  time-dependent  water  surface  elevation 
or  water  depth  profile  associated  with  the  Dirichlet  boundary  node. 

3 

IDHBG) 

0 

Index  of  the  profile  type  for  the  j-th  Dirichlet  boundary  node. 
Time-dependent  water  depth  profile. 

1 

Time-dependent  water  smface  elevation  profile. 

Field 

Variable 

Value  Description 

C  1-2 

ICl 

OB 

Card  group  identifier. 

C3 

IC3 

2 

Flux-type  boundary  sides  for  the  simulation. 

1 

NSCB(j,l) 

-f- 

id  of  global  node  corresponding  to  the  1-st  node  of  the  j-th  flux-type 
boundary  side. 

2 

NSCBa,2) 

+ 

id  of  global  node  corresponding  to  the  2-nd  node  of  the  j-th  flux-type 
boundary  side. 

3 

NSCB0,3) 

1 

id  of  the  type  for  the  j-th  flux-type  boundary  side. 

Upstream  boundary  with  the  incoming  normal  flux  specified. 

2 

Downstream  boundary  with  the  outgoing  normal  flux  specified. 

3 

This  is  either  a  river/stream-related  or  a  river/stream  jimction-related 
boundary  side  with  the  water  depth-dependent  outgoing  normal  flux 
(when  overland  water  and  liver/stream  water  are  separated)  or  stage 
difference-dependent  normal  flux  (when  overland  water  and  river  or 
stream  water  are  coimected)  specified. 

4 

ICTYPG,!) 

+ 

id  of  xy  series  to  describe  the  time-dependent  normal  flux  profile 
associated  with  the  open  boundary  node  when  NSCBG,3)  =  1- 

5 

ICTYP(j,2) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  normal  flux 

profile  associated  with  the  open  boundary  node  when  NSCB(j,3)  =  2, 
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6  ICTYP(j,3)  + 


or  3  (for  the  case  that  river/stream  and  overland  waters  are  separated), 
id  of  xy  series  to  describe  the  water  stage  difference-dependent  normal 
flux  profile  associated  with  the  open  boundary  node  when  NSCB(j,3) 
=  3  (for  the  case  that  river/stream  and  overland  waters  are  connected). 


TC  Card 

Initial  condition  data  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

H 

Water  depth  or  water  surface  elevation. 

1 

IHEAD 

0 

Constant  water  depth  or  water  surface  elevation. 

1 

Variable  water  depth  or  water  surface  elevation. 

2 

IDHEAD 

0 

Initial  water  depth  is  input. 

1 

Initial  water  surface  elevation  is  input. 

3 

HCONST 

+ 

Value  of  the  constant  water  depth  or  water  surface  elevation  for 

IHEAD  =  0.[L] 

Field 

Variable 

Value 

Descriptipn 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

u 

Velocity. 

1 

IV 

0 

Constant  velocity. 

1 

Variable  velocity. 

2 

UCONST 

+ 

Value  of  the  constant  velocity.  [L/T] 

3 

VCONST 

+ 

Value  of  the  constant  velocity.  [L/T] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

s 

Initial  condition  start  type. 

1 

KTART 

0 

Cold  start,  water  depth/water  surface  elevation  and  velocity. 

1 

Hot  start,  water  surface  elevation  and  velocity. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

T 

Initial  condition  start  time. 

1 

HSTIME 

+ 

Time  corresponding  for  the  hot  start. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

F 

Initial  condition  start  type. 

1 

ICFILE 

0 

Text  format. 

1 

Binary  format. 

XYCard 

X-Y  Series  Parameters 

Field 

Variable 

Value  Description 

C  1-2 

ICl 

XY 

Card  group  identifier. 
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C3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

-1- 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7 

TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line 

up  to  NPOINT(i). 

ENCard 

End  of  data  control 

Field 

Variable 

Value  Description 

Cl-2 

ICl 

EN 

Card  group  identifier. 

C3 

IC3 

D 

End  of  input  data. 

2-D  Overland  Transport  FUes  (.2tp  files  for  2-D  overland  simulations) 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

OP  Card 

Run  option  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

1 

Simulation  selection. 

1 

IDCHEM 

Index  of  chemical  transport  simulation. 

0 

Chemical  transport  is  not  simulated. 

1 

Chemical  transport  is  simulated. 

2 

IDSED 

Index  of  sediment  transport  simulation. 

0 

Sediment  transport  is  not  simulated. 

1 

Sediment  transport  is  simulated. 

Field 

Variable 

Value 

Description 

Cl-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

2 

Solver  specification. 

1 

ILUMPT 

Index  of  using  mass  lumping  for  transport  simulations. 

0 

No  mass  lumping. 

1 

Mass  lumping. 

2 

IPNTST 

Index  of  using  linear  matrix  solver  for  transport  simulations. 

1 

The  pointwise  iterative  matrix  solver. 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial), 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUART 

Index  of  using  quadrature  for  numerical  integration. 

1 

Nodal  quadrature  for  line  element  integration. 
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2 

Gaussian  quadrature  for  line  element  integration. 

4 

lADAPT 

0 

Index  of  using  adapted  implicit-explicit  scheme  for  the  predictor  step. 
No. 

1 

Yes. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

3 

Weighting  factor  for  transport  simulations. 

1 

WT 

0.5 

Time  derivative  weighting  factor  for  transport  simulation. 
Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OMET 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 

O.O-l.OUnder  relaxation. 

1.0 

Exact  relaxation. 

1 .0-2.00ver  relaxation. 

3 

OMTT 

Relaxation  parameter  for  solving  linearized  matrix  equation. 

O.O-l.OUnder  relaxation. 

1.0 

Exact  relaxation. 

1.0-2.00ver  relaxation. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

lEIGENT 

0 

GGT  will  not  be  read. 

1 

GGT  will  be  read. 

2 

GGT 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient  matrix 
used  in  the  Preconditioned  Conjugate  Gradient  method. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IP 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

NNUERT 

+ 

Allowed  number  for  the  non-linear  iteration. 

2 

NPUER 

+ 

Allowed  number  for  the  linearized  iteration. 

3 

TOLBT 

+ 

Allowed  relative  error  for  getting  convergent  transport  solutions. 

PTCard 

Particle  tracking  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

PT 

Card  group  identifier. 

C3 

IC3 

1 

Particle  tracking  controlling  parameters. 

1 

NXWT 

+ 

Subelement  number  in  one  direction  that  is  used  in  the  “in-element” 
particle  tracking.  The  total  subelement  number  included  in  one  global 
element  is  NXWT*NXWT. 

2 

IDETQT 

Index  of  particle  tracking  approach. 
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1  Using  the  average-velocity  approach. 

2  Using  the  constant-velocity  approach. 


MP  Card 

Fi?14 

Variable 

Value 

De$priptipn 

Cl-2 

ICl 

MP 

Card  group  identifier. 

C3 

IC3 

1 

Material  property  for  transport. 

1 

i 

+ 

id  of  material  type. 

2 

PROPT(l,i) 

+ 

longitudinal  dispersivity  associated  with  the  material  type.  [L] 

3 

PROPT(2,i) 

+ 

Lateral  dispersivity  associated  with  the  material  type.  [L] 

4 

PROPT(3,i) 

+ 

Pure  diffusion  coefficient  associated  with  the  material  type.  [L^/T] 

SS  card 

Source/sink  parameters 

Esld 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

1 

Source/sink  profile  for  dissolved  chemicals. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  dissolved  chemical. 

3 

rrsRCNPj) 

+ 

Index  of  the  source/sink  XY  series  for  dissolved  chemical  at  the  node. 

Held 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

2 

Source/sink  profile  for  suspended  sediment. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment  size. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

ITSR(m) 

+ 

Index  of  the  source/sink  XY  series  for  the  suspended  sediment  size 
at  the  global  node,  where  m  =  NCHEM  +  j. 

Field 

Variable 

Value 

Dcspription 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

3 

Source/sink  profile  for  particulate  chemicals  on  suspended  sediments. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment. 

3 

k 

+ 

id  of  particulate  chemical. 

4 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

5 

NSSIZE 

+ 

Number  of  sediment  sizes. 

6 

ITSR(m) 

+ 

Index  of  the  source/sink  XY  series  for  the  particulate  chemical  on  the 
suspended  sediment  size  at  the  global  node,  where  m  =  NCHEM  + 
NSSIZE  +  (j-l)*NCHEM  +  k,  j  e[l, NSSIZE],  and  k  e[I,  NCHEM]. 

DBCard 

Dirichlet  boundarv  parameters 

Field 

Variable 

Value  Pe$cription 

C  1-2 

ICl 

DB 

Card  group  identifier. 
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C  3 

IC3 

1 

Dirichlet  boundary  conditions  for  dissolved  chemicals. 

1 

NP 

+ 

id  of  Dirichlet  boundary  node. 

2 

NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3 

i 

+ 

id  of  dissolved  Chemical. 

4 

IDTYPT(NP,i)+ 

Index  of  the  concentration  X  Y  series  with  the  Dirichlet  boundary  node 

for  the  dissolved  chemical. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

DB 

Card  group  identifier. 

C  3 

IC3 

2 

Dirichlet  boundary  conditions  for  suspended  sediments. 

1 

NP 

+ 

id  of  Dirichlet  boundary  node. 

2 

NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3 

k 

+ 

id  of  suspended  sediment  size. 

4 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

5 

IDTYPT(NP,i)+ 

Index  of  the  concentration  X  Y  series  with  the  Dirichlet  boundary  node 

for  the  suspended  sediment,  where  i  =  NCHEM-^k. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

DB 

Card  group  identifier. 

C3 

IC3 

3 

Dirichlet  boundary  conditions  for  particulate  chemicals  on  suspended 
sediments. 

1 

NP 

+ 

id  of  Dirichlet  boundary  node. 

2 

NPDBT(NP) 

+ 

id  of  global  node  corresponding  to  the  Dirichlet  boundary  node. 

3 

j 

+ 

id  of  suspended  sediment  size. 

4 

k 

+ 

id  of  particulate  chemical. 

5 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

6 

NSSIZE 

+ 

Number  of  sediment  sizes. 

7 

IDTYPT(NP,i)+ 

Index  of  the  concentration  XY  series  for  the  particulate  chemical  on 

the  suspended  sediment,  where  i  -  NCHEM  +  NSSIZE  +  (/- 
1)*NCHEM  +  k,  j  e[l, NSSIZE],  and  k  e[I,  NCHEM]. 

FB  Card 

Flux-tvpe  boundary  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

FB 

Card  group  identifier. 

C  3 

IC3 

1 

Flux-type  boundary  conditions  for  dissolved  chemicals. 

1 

NS 

+ 

id  of  flux-type  boundary  side. 

2 

NSCBT(NS,1)+ 

id  of  global  node  corresponding  to  the  1-st  node  of  the  flux-type 

boundary  side. 

3 

NSCBT(NS,2)+ 

id  of  global  node  corresponding  to  the  2-nd  node  of  the  flux-type 

NSCBT(NS,3) 


1 


boundary  side. 

Index  of  boundary  condition  type  for  the  flux-type  boundary  side. 
Variable  boundary  node  with  the  concentration  specified  if  the  flow 
is  incoming. 

Cauchy  boundary  node  with  Cauchy  flux  specified. 
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5 

6 


Field 
C  1-2 
C  3 
1 
2 

3 

4 


5 

6 
7 


Field 
C  1-2 
C3 

1 

2 


3  Neumann  boundary  node  Neumaim  flux  specifled. 

4  River/stream-related  or  a  river/stream  junction-related  boundary  node. 
The  boundary  condition  is  a  Variable  boxmdary  condition.  However, 
the  concentrations  along  with  the  inward  flow  are  not  prescribed. 
Rather  they  are  the  concentrations  at  the  river/stream  node  or 
river/stream  junction  for  the  time  being. 

i  +  id  of  dissolved  Chemical. 

ICTYPT(NS,i)+  Index  of  the  flux  XY  series  at  the  flux-type  boundary  side  for  the 

dissolved  chemical.  It  is  a  concentration  profile  when  NSCBT(j,2)  = 
1,  a  Cauchy  flux  profile  when  NSCBT(j,2)  =  2,  and  a  Neumann  flux 
profile  when  NSCBT(j,2)  =  3. 

Description 
Card  group  identifier. 

Hux-type  boundary  conditions  for  suspended  sediments, 
id  of  flux-type  boundary  side. 

id  of  global  node  corresponding  to  the  1-st  node  of  the  flux-type 
boundary  side. 

id  of  global  node  corresponding  to  the  2-nd  node  of  the  flux-type 
boundary  side. 

Index  of  boundary  condition  type  for  the  flux-type  boundary  side. 
Variable  boundary  node  with  the  concentration  specified  if  the  flow 
is  incoming. 

Cauchy  boimdary  node  with  the  Cauchy  flux  specified. 

Neumann  boundary  node  with  the  Neumann  flux  specified. 
River/stream-related  or  a  river/stream  junction-related  boundary  node. 
The  boundary  condition  is  a  Variable  boundary  condition.  However, 
the  concentrations  along  with  the  inward  flow  are  not  prescribed. 
Rather  they  are  the  concentrations  at  the  river/stream  node  or 
river/stream  junction  for  the  time  being, 
id  of  suspended  sediment  size. 

Number  of  dissolved  chemicals. 

Index  of  the  flux  XY  series  at  the  flux-type  boimdary  side  for  the 
suspended  sediment,  where  i  =  NCHEM+k.  It  is  a  concentration 
profile  when  NSCBT(j,2)  =  1,  a  Cauchy  flux  profile  when  NSCBT(j,2) 
=  2,  and  a  Neumann  flux  profile  when  NSCBT(j,2)  =  3. 

Variable  Value  Description 

ICl  FB  Card  group  identifier. 

IC3  3  Flux-type  boundary  conditions  for  particulate  chemicals  on  suspended 

sediments. 

NS  +  id  of  flux-type  boundary  side. 

NSCBT(NS,1)+  id  of  global  node  corresponding  to  the  1-st  node  of  the  flux-type 

boundary  side. 


Variable  Value 
ICl  FB 

IC3  2 

NS  + 

NSCBT(NS,1)+ 

NSCBT(NS,2)+ 

NSCBT(NS,3) 

1 

2 

3 

4 


k  + 

NCHEM  + 
ICTYPT(NS,i)+ 
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3 


4 


5 

6 

7 

8 
9 


NSCBT(NS,2)+ 

NSCBT(NS,3) 

1 

2 

3 

4 


J 

+ 

k 

+ 

NCHEM 

+ 

NSSIZE 

+ 

ICTYPT(NS,i)+ 

id  of  global  node  corresponding  to  the  2-nd  node  of  the  flux-type 
boundary  side. 

Index  of  boundary  condition  type  for  the  flux-type  boundary  side. 
Variable  boundary  node  with  the  concentration  specified  if  the  flow 
is  incoming. 

Cauchy  boundary  node  with  the  Cauchy  flux  specified. 

Neumann  boundary  node  with  the  Neumaim  flux  specified. 
River/stream-related  or  a  river/stream  junction-related  boundary  node. 
The  boimdary  condition  is  a  Variable  boundary  condition.  However, 
the  concentrations  along  with  the  inward  flow  are  not  prescribed. 
Rather  they  are  the  concentrations  at  the  river/stream  node  or 
river  or  stream  junction  for  the  time  being, 
id  of  suspended  sediment  size, 
id  of  particulate  chemical. 

Number  of  dissolved  chemicals. 

Number  of  sediment  sizes. 

Index  of  the  flux  XY  series  with  the  flux-type  boundary  side  for  the 
particulate  chemical  on  the  suspended  sediment,  where  i  =  NCHEM 
+  NSSIZE  +  (j-l)*NCHEM  +  k,  j  e  [INSSIZE],  and  k  e  [1, 
NCHEM].  It  is  a  concentration  profile  when  NSCBT(j,2)  =  1,  a 
Cauchy  flux  profile  when  NSCBT(j,2)  =  2,  and  a  Neumann  flux  profile 
whenNSCBT(j,2)  =  3. 


RS  card 

Field  Variable 


C  1-2 

ICl 

C3 

IC3 

1 

j 

2 

IRC(j) 

IC  card 

Field 

C  1-2 

ICl 

C3 

IC3 

1 

IDCONC 

Field 

Variable 

Cl-2  ICl 
C3  IC3 

1  j 

2  CCONST(j) 


Rainfall  source  parameters 
Value  Description 
RS  Card  group  identifier. 

1  Rainfall  source  profile  for  dissolved  chemicals. 

+  id  of  dissolved  chemical. 

+  Index  of  the  rainfall  XY  series  for  the  dissolved  chemical. 

Initial  condition  parameters 
Value  Description 
IC  Card  group  identifier. 

1  Initial  condition  parameters. 

id  of  initial  concentrations. 

0  constant  initial  concentrations. 

1  variable  initial  concentrations. 

Value  Description 
IC  Card  group  identifier. 

2  Initially  constant  conditions  for  dissolved  chemicals. 

+  id  of  the  dissolved  chemical  being  input. 

+  Specified  initial  concentration  for  the  dissolved  chemical.  [M/L^] 
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Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

3 

Initially  constant  conditions  for  particulate  chemicals  on  suspended 
sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  suspended  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on 
suspended  sediment  being  input,  where  k  =  i*NCHEM  +  j.  [M/M] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

4 

Initially  constant  conditions  for  particulate  chemicals  on  bed  sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  bed  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

NSSIZE 

+ 

Number  of  sediment  sizes. 

5 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on  the  bed 
sediment  being  input,  where  k  =  (i+NSSIZE)*  NCHEM  +  j.  [M/M] 

Esld 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

5 

Initially  constant  conditions  for  suspended  sediments. 

1 

i 

+ 

id  of  the  suspended  sediment  size  being  input. 

2 

SCONST(i) 

+ 

Specified  initial  concentration  for  the  suspended  sediment  of  the  i-th 
size.  [M/L^] 

Fi?ld 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

6 

Initially  constant  conditions  for  bed  sediments. 

1 

i 

+ 

id  of  the  bed  sediment  size  being  input. 

2 

NSSIZE 

+ 

Number  of  sediment  sizes. 

3 

SCONST(k) 

+ 

Specified  initial  concentration  for  the  bed  sediment  of  the  i-th  size, 
where  k  =  NSSIZE  +  i.  [M/L^] 

XYCard 

X-Y  Series  Parameters 

Fi?ld 

Variable 

Value 

Description 

C  1-2 

ICl 

XY 

Card  group  identifier. 

C3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 
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6  BEGCYC 

7  TNAME 
(new  line)X,Y 


Dummy  values. 

A  character  string  representing  the  name  of  the  XY  series. 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line 
up  to  NPOINT(i). 


Field  Vari 
Cl-2  ICl 
C3  ICS 


Value  Description 
EN  Card  group  identifier. 

D  End  of  input  data. 


1-D  River/stream  Geometry  File  (.2dm  files  for  1-D  river/stream  simulations) 


Only  one  Tl,  T2,  and  T3  card  can  be  used. 


Field  Variable 
Cl-2  ICl 
C3  ICS 

1  M 

2  IE1(M,1) 

3  IE1(M,2) 

4  IE1(M,3) 


Element  information 
Value  Description 

GE  Card  group  identifier. 

2  Identification  of  element. 

+  id  of  global  element. 

+  The  index  of  node  nmnber  1  of  the  M  element 

+  The  index  of  node  number  2  of  the  M  element 

+  id  of  the  material  type  of  the  global  element. 


Field  Var 
Cl-2  ICl 
C3  ICS 

1  N 

2  Xl( 

3  Xl( 


ICS 

N 

X1(N,1) 

X1(N,2) 


Node  information 
Value  Description 
GN  Card  group  identifier, 
blank. 

+  id  of  Global  node. 

+  The  x-coordinate  of  the  global  node. 

+  The  z-coordinate  (bottom  elevation)  of  the  global  node. 


EN  Card 
Field  Variable 
Cl-2  ICl 
C3  ICS 


Value  Description 
EN  Card  group  identifier. 

D  End  of  input  data. 


1-D  River/stream  Flow  File  (.2bc  files  for  1-D  river/stream  simulations) 


Only  one  Tl,  T2,  and  T3  card  can  be  used. 


Field  Variable  Value 
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C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

1 

Simulation  selection. 

1 

KMOD 

0 

Index  of  river/stream  simulation. 

No  river/stream  simulation. 

1 

Only  flow  is  simulated. 

2 

Both  flow  and  transport  are  simulated. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

2 

Solver  specification. 

1 

ILUMP 

0 

Index  of  using  mass  lumping. 

No  mass  lumping. 

1 

Mass  lumping. 

2 

PNTS 

1 

Index  of  using  linear  matrix  solver  for  flow  simulations. 

The  pointwise  iterative  matrix  solver. 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial), 

3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUAR 

1 

Index  of  using  quadrature  for  numerical  integration. 

Nodal  quadrature  for  line  element  integration. 

2 

Gaussian  quadrature  for  line  element  integration. 

4 

IDIFF 

1 

Index  of  taking  into  account  the  eddy  viscosity  terms. 

Yes. 

0 

No,  the  eddy  viscosity  terms  are  neglected. 

5 

lALLOW 

1 

Index  of  allowing  the  simulation  to  continue  when  there  is  no 
convergence  reached  for  the  non-linear  iteration. 

Yes. 

0 

No. 

6 

MODEL 

3 

Index  of  simulating  overland  flow. 

Using  MOC  to  solve  the  dynamic  model  only. 

2 

Using  the  diffusion  model  only. 

1 

Using  the  kinematic  model  only. 

0 

Using  the  hybrid  model . 

-10 

Specifying  water  depth  and  velocity  as  the  initial  conditions.  The 
flow  equation  is  not  solved. 

Fipld 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

3 

Weighting  factor  for  simulations. 

1 

W 

0.5 

Time  derivative  weighting  factor  for  flow  simulation. 

Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OME 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 

0.0- 1  .OUnder  relaxation.  I 

1.0 

Exact  relaxation.  1 
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1.0-2.00ver  relaxation. 

3  OMI  Relaxation  parameter  for  solving  linearized  matrix  equation. 

O.O-l.OUnder  relaxation. 

1.0  Exact  relaxation. 

1 .0-2.00ver  relaxation. 


Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

EIGEN 

0 

GGT  will  not  be  read. 

1 

GGT  will  be  read. 

2 

GG 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient  matrix 
used  in  the  Preconditioned  Conjugate  Gradient  method. 

gCard 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IP 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

NNITER 

+ 

Allowed  number  for  the  non-linear  iteration  in  the  flow  simulation. 

2 

NPUER 

+ 

Allowed  number  for  the  linearized  iteration  in  the  flow  simulation. 

3 

TOLBH 

+ 

Allowed  relative  error  for  water  depth. 

4 

TOLBV 

+ 

Allowed  relative  error  for  velocity  components. 

5 

V_CUT 

+ 

Cut-off  of  velocity.  If  the  computed  velocity  is  smaller  than  this  value, 
it  is  set  to  zero. 

6 

FMSR 

+ 

Multiplication  factor  to  set  the  allowed  mean  square  root  errors, 
BHMSR  for  water  depth  and  B  VMSR  for  velocity,  where  BHMSR 
=  TOLBH*FMSR;  B  VMSR  =  TOLB  V*FMSR. 

FT  Card 

Particle  tracking  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

PT 

Card  group  identifier. 

C3 

IC3 

1 

Particle  tracking  controlling  parameters. 

1 

NXW 

+ 

Subelement  number  used  in  the  x-direction  in  the  “in-element” 
particle  tracking. 

2 

IDETQ 

1 

Index  of  particle  tracking  approach. 

Using  the  average-velocity  approach. 

2 

Using  the  constant-velocity  approach. 

TC  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

TC 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

TMAX 

+ 

Maximum  simulation  time.  [T] 

2 

DELT 

+ 

Initial  time  step  size.  [T] 
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Field  Variable 

Value 

Description 

Cl-2  ICl 

TC 

Card  group  identifier. 

C3  ICS 

2 

Computational  time  step. 

1  IDTXY 

+ 

Index  of  xy  series  for  variable  time  step. 

PC  Card 

Output  control  parameters 

Field  Variable 

Value  Description 

Cl-2  ICl 

PC 

Card  group  identifier. 

C3  ICS 

1 

Print  control  parameters. 

1  IBUG 

0 

Do  not  print  the  diagnostic  output. 

1 

Do  print  the  diagnostic  output. 

2  JOPT 

0 

Print  at  specified  interval. 

1 

Print  at  specified  set  of  time  values. 

3  KPRT 

+ 

Specify  the  interval  if  JOPT  =  0. 

NPRINT 

+ 

Specify  total  number  of  the  specified  times,  if  JOPT=l. 

Note:  NPRINT  new 
(the  first  new  line) 

lines  after  PCI  card  are  needed  if  JOPT  =  1. 

1  TPRT(l) 

(the  second  new  line) 

+ 

The  1-st  specified  time  that  the  simulation  results  are  to  be  printed. 

1  TPRT(2) 

+ 

The  2-nd  specified  time  that  the  simulation  results  are  to  be  printed. 

(the  NPRINT  new  line) 

1  TPRT(NPRINT)  + 

The  NPRINT-th  specified  time  that  the  simulation  results  are  to  be 
printed. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

PC 

Card  group  identifier 

C3  ICS 

2 

Print  options. 

1  NSELT 

+ 

Total  options  to  be  selected. 

2  KPRO(i) 

Print  options. 

1 

Print  water  depth. 

2 

Print  velocity. 

3 

Print  infiltration  rate. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

PC 

Card  group  identifier. 

C3  ICS 

3 

Output  control  for  post-process. 

1  MLE 

0 

Save  as  ascii  format. 

1 

Save  as  binary  format. 

2  KOPT 

0 

Save  at  specified  interval. 

1 

Save  at  specified  set  of  times. 

3  KDSK 

+ 

Save  every  specified  interval,  if  KOPT=0. 

NPOST 

+ 

Save  at  specified  set  of  times,  if  KOPT=l. 
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J^Qte:  NPOST  new  lines  after  OC3  card  are  needed  if  KOPT  =  1. 

(the  first  new  line) 

1  TSV(l) 

+ 

The  1-st  specified  time  that  the  simulation  results  are  to  be  saved. 

(the  second  new  line) 

1  TSV(2) 

+ 

The  2-nd  specified  time  that  the  simulation  results  are  to  be  saved. 

(the  NPOST  new  line) 

1  TSV(NPOST)  + 

The  NPOST-th  specified  time  that  the  simulation  results  are  to  be 

saved. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C3  IC3 

4 

Solution  file  output  options. 

1  KSELT 

+ 

Total  options  to  be  selected. 

2  KSAVE(i) 

Save  options. 

1 

Save  water  depth. 

2 

Save  flux. 

3 

Save  infiltration  rate. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C3  IC3 

5 

Print  options  for  1-D  groundwater  flow. 

1  NCOLUM 

+ 

Total  vertical  column  to  be  printed. 

Npte:  NCOLUM  new  lines  after  OC5  card  are  needed. 

(the  first  new  line) 

1  ICL(l) 

+ 

The  1-st  specified  vertical  column  that  the  groundwater  flow  are  to  be 

printed. 

(the  second  new  line) 

1  ICL(2) 

+ 

The  2-nd  specified  vertical  column  that  the  groundwater  flow  are  to 

be  printed. 

(the  NPRINT  new  line) 

1  ICL(NCOLUM)  + 

The  NCOLUM-th  specified  vertical  column  that  the  groundwater  flow 

are  to  be  printed. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OC 

Card  group  identifier. 

C3  IC3 

6 

Print  1-D  groundwater  model  options. 

1  NSELTG 

+ 

Total  options  to  be  selected. 

2  KPRG(i) 

Print  options. 

1 

Print  pressure  head. 

2 

Print  water  contents. 

3 

Print  velocity. 

GC  Card 

Cross  section  parameters 
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Field  Variable 

Value 

Description 

Cl-2  ICl 

GC 

Card  group  identifier. 

C3  ICS 

1 

Generate  cross  section  to  calculate  discharge. 

1  NGCL 

+ 

Total  number  of  cross  sections. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

GC 

Card  group  identifier. 

C3  ICS 

2 

Cross  section  information. 

1  id 

+ 

Index  number  of  cross  section. 

2  NPL 

+ 

Number  of  nodal  points  in  the  x-section. 

(new  line) 

+ 

Node  points. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

GC 

Card  group  identifier. 

C3  ICS 

3 

Save  and  print  hydrograph. 

1  LOPT 

0 

Save  and  print  at  specified  interval. 

1 

Save  and  print  at  specified  set  of  times. 

2  LDSK 

0 

Save  and  print  at  specified  interval. 

+ 

Save  and  print  every  specified  interval,  if  LOPT=0. 

LPOST 

+ 

Save  and  print  at  specified  set  of  times,  if  LOPT=l. 

Note:  LPOST  new  lines  after  GC3  card  are  needed  if  LOPT  =  1. 

(the  first  new  line) 

1  TSA(l) 

(the  second  new  line) 

+ 

The  1-st  specified  time  that  the  hydrographs  are  to  be  saved. 

1  TSA(2) 

+ 

The  2-nd  specified  time  that  the  hydrographs  are  to  be  saved. 

(the  NPOST  new  line) 

1  TSA(LPOST)  -1- 

The  LPOST-th  specified  time  that  the  hydrographs  are  to  be  saved. 

(new  line) 

After  GC3  card,  specify  the  times,  if  LOPT  =  1.  One  data  entry  per 
line. 

MPCard 

Material  property  parameters 

Field  Variable 

Value 

Description 

Cl-2  ICl 

MP 

Card  group  identifier. 

C3  ICS 

1 

Material  property. 

1  i 

+ 

id  of  material  type. 

2  PROP(l,i) 

+ 

Manning’s  roughness  associated  with  the  material  type. 

3  PROP(2,i) 

+ 

x-eddy  viscosity  associated  with  the  material  type.  [L^/T] 

Field  Variable 

Value 

Description 

Cl-2  ICl 

MP 

Card  group  identifier. 

C3  ICS 

2 

Density  of  water  and  acceleration  of  gravity. 

1  rruNTT 

Index  of  time  unit. 

1 

The  time  unit  for  simulation  is  second. 
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2 

The  time  unit  for  simulation  is  minute. 

3 

The  time  unit  for  simulation  is  hour. 

2 

ILUNTT 

1 

Index  of  length  unit. 

The  length  unit  for  simulation  is  meter. 

2 

The  length  unit  for  simulation  is  foot. 

3 

The  length  unit  for  simulation  is  kilometer. 

4 

The  length  unit  for  simulation  is  mile. 

3 

RHO 

+ 

Density  of  water.  [M/L^] 

SP  Card 

Soil  property  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

SP 

Card  group  identifier. 

C3 

IC3 

1 

Index  for  computing  the  infiltration. 

1 

KSP 

0 

Index  of  infiltration  rate. 

Input  the  infiltration  rate. 

1 

Computed  by  1-D  yertical  groundwater  model. 

RFCard 

Rainfall  parameters 

Fiel4 

Variable 

Value 

Description 

C  1-2 

ICl 

RF 

Card  group  identifier. 

C3 

IC3 

1 

Rainfall  data  for  the  simulation. 

1 

i 

+ 

id  of  global  element. 

2 

IRTYP(i) 

+ 

Index  of  the  rainfall  XY  series  for  the  element. 

SS  Card 

Source/sink  parameters 

Fiel4 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

1 

Source/sink  data  for  the  simulation. 

1 

i 

+ 

id  of  global  node. 

2 

ISR(i) 

+ 

Index  of  the  source/sink  XY  series  for  the  node. 

IN  Card 

Infiltration  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IN 

Card  group  identifier. 

C3 

IC3 

1 

Input  for  Infiltration  data. 

1 

i 

+ 

id  of  global  node. 

2 

ROUTND(i) 

+ 

Input  infiltration  rate  for  the  node.  [L/T] 

OB  Card 

Open  boundary  parameters 

Fipld 

Variable 

Value 

Description 

C  1-2 

ICl 

OB 

Card  group  identifier. 

C  3 

IC3 

1 

Open  boundary  for  the  simulation. 

1 

NPDB(j,l) 

+ 

id  of  global  node  corresponding  to  the  j-th  open  boundary  node. 

2 

NPDB(j.2) 

id  of  the  type  for  the  open  boundary  node. 
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1 

Boundary  node  with  the  water  surface  elevation  specified. 

2 

Upstream  boundary  node  with  the  incoming  normal  flux  specified. 

3 

Downstream  boundary  node  with  the  outgoing  normal  flux  specified. 

3 

IDTYP(j,l) 

+ 

id  of  xy  series  to  describe  the  water  surface  elevation  or  water  depth 
profile  associated  with  the  open  boimdary  node  when  NPDB(j,2)  =  1. 

4 

IDTYP(j,2) 

+ 

id  of  xy  series  to  describe  the  normal  flux  profile  associated  with  the 
open  boundary  node  when  NPDB(j,2)  =  2. 

5 

IDTYP(j,3) 

-t- 

id  of  xy  series  to  describe  the  water  depth-dependent  normal  flux 
profile  associated  with  the  open  boundary  node  when  NPDB(j,2)  =  3. 

6 

IDHBG) 

0 

Index  of  the  profile  type  for  IDTYP(j,2)  when  NPDB(j,2)  =  2. 
Time-dependent  water  depth  profile. 

1 

Time-dependent  water  surface  elevation  profile. 

CS  Card 

River/stream  cross-sectional  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

CS 

Card  group  identifier. 

C  3 

IC3 

1 

Profile  types  for  river/stream  cross-sectional  geometry. 

1 

j 

+ 

id  of  river/stream  node. 

2 

ICHNOM) 

4- 

id  of  xy  series  to  describe  the  water  depth-dependent  cross-sectional 
area  profile  for  the  river/stream  node. 

3 

ICHN(j,2) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  wetted  perimeter 
profile  for  the  river/stream  node. 

4 

ICHNa,3) 

+ 

id  of  xy  series  to  describe  the  water  depth-dependent  top  river/stream 
width  profile  for  the  river/stream  node. 

Note: 

The  top  river/stream  width  value  at  zero  water  depth  must  be  GREATER  than  zero  when 
describing  the  profile  associated  with  it. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

CS 

Card  group  identifier. 

C  3 

IC3 

2 

Entire  river/stream  width . 

1 

j 

+ 

id  of  river/stream  node. 

2 

CHNW(j) 

+ 

The  entire  river/stream  width  through  which  rainfall  can  contribute 
to  river/stream  at  the  river/stream  node.  [L] 

RHCard 

River/stream  reach  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

RH 

Card  group  identifier. 

C  3 

IC3 

1 

River/stream  nodes  included  in  each  river/stream  reach. 

1 

j 

+ 

id  of  river/stream  reach. 

2 

nn 

+ 

Number  of  nodes  included  in  the  river/stream  reach. 

Note:  A  river/stream  reach  must  include  at  least  four  river/stream  nodes.  One  new  line  after  RHl 
card  is  needed. 

(new  line,  including  nn  data) 
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NPINRH(l..nn,j)  + 


Node  numbers  of  river/stream  nodes  that  are  included  in  the 
river/stream  reach.  These  nodes  must  be  given  in  order  from  the 
upstream  to  the  downstream. 


JT  Card 

Field  Variable 


River/stream  junctions 
Value  Descrintion 


C  1-2 

ICl 

JT 

Card  group  identifier. 

C3 

ICS 

1 

parameters  of  junction  geometry. 

1 

j 

+ 

id  of  river/stream  junction. 

2 

NPJT(j) 

+ 

id  of  overland  global  node  that  is  associated  with  the  j-th  junction. 

3 

IVJT(j) 

+ 

id  of  xy  series  to  describe  the  volmne-water  depth  relation  at  the 
river/stream  junction. 

4 

BDJCNTO) 

1 

This  junction  is  to  simulate  a  big  lake  and  the  water  stage  at  junction’ s 
outlets  are  considered  to  be  the  same  as  the  junction’s. 

0 

Otherwise. 

5 

AJT(j) 

+ 

Horizontal  area  of  the  junction,  through  which  both  rainfall  and 
infiltration  can  contribute  to  the  change  of  water  depth  of  the  junction. 

[L^l 

6 

Z0JT(j) 

+ 

Bottom  elevation  of  the  junction.  [L] 

Fi^ld 

Variable 

Value  Description 

Cl-2 

ICl 

JT 

Card  group  identifier. 

C3 

ICS 

2 

river/stream  reaches  and  nodes  associated  with  liver/stream  junctions. 

1 

j 

id  of  river/stream  junction. 

2 

NJTRHO) 

-1- 

Number  of  river/stream  reaches  that  connect  to  one  another  through 

the  river/stream  junction. 

Note:  If  this  river/stream  junction  is  simulating  a  pond  without  outlet,  NJTRH(j)  =  0. 

(new  line)  ID  JT  ( 1 , 1 .  .nn,j )  id  of  liver/stream  global  nodes  which  coincide  with  the  junction  and 

are  the  end  nodes  of  the  reaches  connected  to  the  jimction.  (nn  = 
NJTRHO)) 

(new  line)  DJT(2, 1  ..nn,j)  id  of  river/stream  global  nodes  which  are  the  nodes  next  to  the  nodes 

specified  in  ID JT(  1,1.. im,j).  (nn  =  NJTRH(j)) 

Note:  IDJT(  1  ,i,j)  must  match  IDJT(2,i,j)  for  the  i-th  reach  connected  to  the  j-th  junction. 


Field  Variable 
Cl-2  ICl 
C3  ICS 


Value  Description 
JT  Card  group  identifier. 

3  junction-related  overland  boundary  sides. 

+  id  of  river/stream  junction. 


Note:  A  river/stream  dead  end  is  treated  as  a  river/stream  junction. 

2  NJT12(j)  +  Number  of  junction-related  overland  boundary  segments. 

Note:  nn  new  lines  after  JT3  card  are  needed,  where  nn  =  NJT12(j). 

(the  first  new  line) 

1  NSJT12(1,1)  +  The  2D  global  node  that  corresponds  to  the  1-st  node  of  the  1-st 
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2  NSJT12(2,1)  + 


surrounding  overland  boundary  segment  of  the  river/stream  junction. 
The  2D  global  node  that  corresponds  to  the  2-nd  node  of  the  1-st 
surrounding  overland  boundary  segment  of  the  river/stream  junction. 

(the  nn-th  new  line) 

1  NSJT12(l,rm)  +  The  2D  global  node  that  corresponds  to  the  1-st  node  of  the  im-th 

surrounding  overland  botmdary  segment  of  the  river/stream  junction. 

2  NSJT12(2,rm)  +  The  2D  global  node  that  corresponds  to  the  2-nd  node  of  the  rm-th 

surrounding  overland  boundary  segment  of  the  river/stream  junction. 


IC  Card 

Initial  condition  data  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

H 

Water  depth  or  water  surface  elevation. 

1 

IHEAD 

0 

Constant  water  depth  or  water  surface  elevation. 

1 

Variable  water  depth  or  water  surface  elevation. 

2 

IDHEAD 

0 

Initial  water  depth  is  input. 

1 

Initial  water  surface  elevation  is  input. 

3 

HCONST 

+ 

Value  of  the  constant  water  depth  or  water  surface  elevation  for 
IHEAD  =  0.  [L] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C  3 

IC3 

U 

Velocity. 

1 

IV 

0 

Constant  velocity. 

1 

Variable  velocity. 

2 

UCONST 

+ 

Value  of  the  constant  velocity.  [L/T] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C  3 

IC3 

s 

Initial  condition  start  type. 

1 

ISTART 

0 

Cold  start,  water  depth/water  surface  elevation  and  velocity. 

1 

Hot  start,  water  surface  elevation  and  velocity. 

Field 

Variable 

Value  Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

T 

Initial  condition  start  time. 

1 

HSTIME 

+ 

Time  corresponding  for  the  hot  start. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C  3 

IC3 

F 

Initial  condition  start  type. 

1 

ICFILE 

0 

Text  format. 

1 

Binary  format. 
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XY  Card 

X-Y  Series  Parameters 

Field  Variable 

Value  Description 

Cl-2  ICl 

XY 

Card  group  identifier. 

C3  ICS 

1 

Generation  of  any  x-y  series  function. 

1  i 

+ 

Index  number  for  x-y  series. 

2  NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3  DELTAX 

0 

Dummy  values. 

4  DELTAY 

0 

Dummy  values. 

5  REPEAT 

0 

Dummy  values. 

6  BEGCYC 

0 

Dummy  values. 

7  TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)  X,Y 

After  X  Y  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line 

up  to  NPOINT(i). 

EN  Card 

End  of  data  control 

Field  Variable 

Value  Description 

Cl-2  ICl 

EN 

Card  group  identifier. 

C3  ICS 

D 

End  of  input  data. 

1-D  River/stream  Transport  File  (.2tp  files  for  2-D  overland  simulations) 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

OP  Card 

Run  option  parameters 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OP 

Card  group  identifier. 

C3  ICS 

1 

Simulation  selection. 

1  IDCHEM 

Index  of  chemical  transport  simulation. 

0 

Chemical  transport  is  not  simulated. 

1 

Chemical  transport  is  simulated. 

2  IDSED 

Index  of  sediment  transport  simulation. 

0 

Sediment  transport  is  not  simulated. 

1 

Sediment  transport  is  simulated. 

Field  Variable 

Value 

Description 

Cl-2  ICl 

OP 

Card  group  identifier. 

C3  ICS 

2 

Solver  specification. 

1  ILUMPT 

Index  of  using  mass  lumping  for  transport  simulations. 

0 

No  mass  lumping. 

1 

Mass  lumping. 

2  IPNTST 

Index  of  using  linear  matrix  solver  for  transport  simulations. 

1 

The  pointwise  iterative  matrix  solver. 

2 

Preconditioned  Conjugate  Gradient  Method  (polynomial). 
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3 

Preconditioned  Conjugate  Gradient  Method  (Incomplete  Cholesky). 

3 

IQUART 

1 

Index  of  using  quadrature  for  numerical  integration. 

,  Nodal  quadrature  for  line  element  integration. 

2 

Gaussian  quadrature  for  line  element  integration. 

4 

lADAPT 

0 

Index  of  using  adapted  implicit-explicit  scheme  for  the  predictor  step. 
No. 

1 

Yes. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

3 

Weighting  factor  for  transport  simulations. 

1 

WT 

0.5 

Time  derivative  weighting  factor  for  transport  simulation. 
Crank-Nicolson  central. 

1.0 

Backward  difference. 

2 

OMET 

Relaxation  parameter  for  solving  nonlinear  matrix  equations. 

O.O-l.OUnder  relaxation. 

1.0 

Exact  relaxation. 

1.0-2.00ver  relaxation. 

3 

OMIT 

Relaxation  parameter  for  solving  linearized  matrix  equation. 

O.O-l.OUnder  relaxation. 

1.0 

Exact  relaxation. 

1.0-2.00ver  relaxation. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

OP 

Card  group  identifier. 

C3 

IC3 

4 

Preconditioned  Conjugate  Gradient  method. 

1 

ffilGENT 

0 

GGT  will  not  be  read. 

1 

GGT  will  be  read. 

2 

GGT 

+ 

Upper  bound  of  the  maximum  eigenvalue  of  the  coefficient 
matrix  used  in  the  Preconditioned  Conjugate  Gradient  method. 

IP  Card 

Iteration  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IP 

Card  group  identifier. 

C3 

IC3 

1 

Total  simulation  time. 

1 

NNTTERT 

+ 

Allowed  number  for  the  non-linear  iteration. 

2 

NPITER 

+ 

Allowed  number  for  the  linearized  iteration. 

3 

TOLBC 

+ 

Allowed  relative  error  for  getting  convergent  transport  solutions  for 
both  dissolved  and  particulate  chemicals.  ' 

4 

TOLBS 

+ 

Allowed  relative  error  for  getting  convergent  transport  solutions  for 

sediments. 

PT  Card  Particle  tracking  parameters 

Field  Variable  Value  Description 
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C  1-2 

ICl 

PT 

Card  group  identifier. 

C3 

IC3 

1 

Particle  tracking  controlling  parameters. 

1 

NXWT 

+ 

Subelement  number  used  in  the  x-direction  in  the  “in-element” 
particle  tracking. 

2 

IDETQT 

1 

Index  of  particle  tracking  approach. 

Using  the  average- velocity  approach. 

2 

Using  the  constant-velocity  approach. 

MPCard 

Material  property  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

MP 

Card  group  identifier. 

C3 

IC3 

1 

Material  property  for  transport. 

1 

i 

+ 

id  of  material  type. 

2 

PROPT(l,i) 

+ 

Lx)ngitudinal  dispersivity  associated  with  the  material  type.  [L] 

3 

PROPT(2,i) 

Pure  diffusion  coefficient  associated  with  the  material  type.  [L^/T] 

SS  card 

Source/sink  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

1 

Source/sink  profile  for  dissolved  chemicals. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  dissolved  chemical. 

3 

ITSR(NP,j) 

+ 

Index  of  the  source/sink  XY  series  for  the  dissolved  chemical  at  the 
global  node. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

2 

Source/sink  profile  for  suspended  sediment. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment  size. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

ITSR(NP,m) 

+ 

Index  of  the  source/sink  XY  series  for  the  suspended  sediment  size 
at  the  global  node,  where  m  =  NCHEM  +  j. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

SS 

Card  group  identifier. 

C3 

IC3 

3 

Source/sink  profile  for  particulate  chemicals  on  suspended  sediments. 

1 

NP 

+ 

id  of  global  node. 

2 

j 

+ 

id  of  suspended  sediment. 

3 

k 

+ 

id  of  particulate  chemical. 

4 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

5 

NSSIZE 

+ 

Number  of  sediment  sizes. 

6 

ITSR(NP,m) 

+ 

Index  of  the  source/sink  XY  series  for  the  particulate  chemical  on  the 
suspended  sediment  size  at  the  global  node,  where  m  =  NCHEM  + 
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NSSIZE  +  (j-l)*NCHEM  +  k,j  e[l,NSSIZE],  and  k  e[l,  NCHEMJ. 


UB  Card 


Field  V 
Cl-2  I( 
C  3  I( 


ICl  U] 

IC3  1 

NP  + 

NPDBT(NP,1)+ 
NPDBT(NP,2) 

1 

2 

3 

4 

i  + 

IDTYPT(NP,i)+ 


Value 

UB 

1 


Card  group  identifier. 

User-specified  boundary  conditions  for  dissolved  chemicals, 
id  of  user-specified  boimdary  node. 

id  of  global  node  corresponding  to  the  user-specified  boundary  node. 
Index  of  boundary  condition  type  for  the  user-specified  boundary  node. 
Dirichlet  boundary  node  with  the  concentration  specified. 

Variable  boundary  node  with  th  concentration  specified  if  the  flow  is 
incoming. 

Cauchy  boundary  node  with  the  Cauchy  flux  specified. 

Neumarm  boundary  node  with  Neumann  flux  specified, 
id  of  dissolved  Chemical. 

Index  of  the  XY  series  associated  with  the  user-specified  boundary 
node  for  the  dissolved  chemical.  It  is  a  concentration  profile  when 
NPDB(j,2)  =  1 ,  a  concentration  profile  when  NPDB(j,2)  =  2,  a  Cauchy 
flux  profile  when  NPDB(j,2)  =  3,  and  a  Neumarm  flux  profile  when 
NPDB(j,2)  =  4. 


EM 

Variable 

Value 

C  1-2 

ICl 

UB 

C  3 

IC3 

2 

1 

NP 

+ 

NPDBT(NP,1H 

NPDBT(NP.2) 

1 

2 


k  -1- 

NCHEM  + 
IDTYPT(NP,i  + 


Field  Variable 
Cl-2  ICl 
C3  IC3 


Card  group  identifier. 

User-specified  boundary  conditions  for  suspended  sediments, 
id  of  user-specified  boundary  node. 

id  of  global  node  corresponding  to  the  user-specified  boundary  node. 
Index  of  boundary  condition  type  for  the  user-specified  boundary  node. 
Dirichlet  boundary  node  with  the  concentration  specified. 

Variable  boundary  node  with  the  concentration  specified  if  the  flow 
is  incoming. 

Cauchy  boundary  node  with  the  Cauchy  flux  specified. 

Neumarm  boundary  node  with  the  Neumann  flux  specified, 
id  of  suspended  sediment  size. 

Number  of  dissolved  chemicals. 

Index  of  the  XY  series  associated  with  the  user-specified  bormdary 
node  for  the  suspended  sediment,  where  i  =  NCHEM+k.  It  is  a 
concentration  profile  when  NPDBT(j,2)  =  1,  a  concentration  profile 
when  NPDBT(j,2)  =  2,  a  Cauchy  flux  profile  when  NPDBT(j,2)  =  3, 
and  a  Neumarm  flux  profile  when  NPDBT(j,2)  =  4. 


Value  Description 
UB  Card  group  identifier. 

3  User-specified  boundary  conditions  for  particulate  chemical.on 

suspended  sediments. 
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1  NP  +  id  of  user-specified  boundary  node. 

2  NPDBT(NP,  1 )+  id  of  global  node  corresponding  to  the  user-specified  boundary  node. 

3  NPDBT(NP,2)  Index  of  boundary  condition  type  for  the  user-specified  boundary  node. 

1  Dirichlet  boundary  node  with  the  concentration  specified. 

2  Variable  boundary  node  with  the  concentration  specified  if  the  flow 
is  incoming. 

3  Cauchy  boundary  node  with  the  Cauchy  flux  specified. 

4  Neumann  boundary  node  with  the  Neumann  flux  specified. 

4  j  +  id  of  suspended  sediment  size. 

5  k  +  id  of  particulate  chemical. 

6  NCHEM  +  Number  of  dissolved  chemicals. 

7  NSSIZH  +  Number  of  sediment  sizes. 

8  IDTYPT(NP,i)+  Index  of  the  XY  series  associated  with  the  user-specified  boundary 

node  for  the  particulate  chemical  on  the  suspended  sediment,  where 
i  =  NCHEM  +  NSSnE  +  (j-l)*NCHEM  +  k,  j  e[l,NSSIZE],  and  k 
efi,  NCHEM].  It  is  a  concentration  profile  when  NPDBT(j,2)  =  1, 
a  concentration  profile  when  NPDBT(j,2)  =  2,  a  Cauchy  flux  profile 
when  NPDBT(j,2)  =  3,  and  a  Neumann  flux  profile  when  NPDBT(j,2) 
=  4. 


RS  card 

Rainfe 

Field  Variable 

Value 

Cl-2  ICl 

RS 

C3  IC3 

1 

1  j 

+ 

2  IRC(j) 

+ 

Description 

Card  group  identifier. 

Rainfall  source  profile  for  dissolved  chemicals, 
id  of  dissolved  chemical. 

Index  of  the  rainfall  XY  series  for  the  dissolved  chemical. 


IC  card 

Field  Variable 
Cl-2  ICl 
C3  IC3 
1  IDCONC 


Value  Description 


Card  group  identifier. 

Initial  condition  parameters, 
id  of  initial  concentrations, 
constant  initial  concentrations, 
variable  initial  concentrations. 


Field  Variable  Value 

Cl-2  ICl  IC 

C  3  IC3  2 

1  j  + 

2  CCONSTO)  + 

Field  Variable  Value 

C  1-2  ICl  IC 

C  3  IC3  3 


Card  group  identifier. 


Initially  constant  conditions  for  dissolved  chemicals 


id  of  the  dissolved  chemical  being  input. 

Specified  initial  concentration  for  the  dissolved  chemical.  [M/L^] 


Card  group  identifier. 


Initially  constant  conditions  for  particulate  chemicals  on  suspended 
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sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  suspended  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on 
suspended  sediment  being  input,  where  k  =  i*NCHEM  +  j.  [M/M] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

1C 

Card  group  identifier. 

C3 

IC3 

4 

Initially  constant  conditions  for  particulate  chemicals  on  bed  sediments 

1 

j 

+ 

id  of  the  particulate  chemical  being  input. 

2 

i 

+ 

id  of  the  bed  sediment  size  where  the  particulate  chemical  is. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

NSSIZE 

+ 

Number  of  sediment  sizes. 

5 

CCONST(k) 

+ 

Specified  initial  concentration  for  the  particulate  chemical  on  the  bed 
sediment  being  input,  where  k  =  (i+NSSIZE)*  NCHEM  +  j.  [M/M] 

Fi?ld 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

5 

Initially  constant  conditions  for  suspended  sediments. 

1 

i 

+ 

id  of  the  suspended  sediment  size  being  input. 

2 

SCONST(i) 

+ 

Specified  initial  concentration  for  the  suspended  sediment  ofthe  i-th 
size.  [M/L^] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

IC 

Card  group  identifier. 

C3 

IC3 

6 

Initially  constant  conditions  for  bed  sediments. 

1 

i 

+ 

id  of  the  bed  sediment  size  being  input. 

2 

NSSIZE 

+ 

Number  of  sediment  sizes. 

3 

SCONST(k) 

+ 

Specified  initial  concentration  for  the  bed  sediment  of  the  i-th  size, 
where  k  =  NSSIZE  +  i.  [M/L^] 

XYCard 

X-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

XY 

Card  group  identifier. 

C3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7 

TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,  Y 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per  line 
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up  to  NPOINT(i). 


End  of  data  control 


Field  Variable  Value  Description 

Cl -2  ICl  EN  Card  group  identifier. 

C  3  IC3  D  End  of  input  data. 


1-D/2-D  Contaminant/sediment  File  (.2ch  files  for  transport  simulations) 


T1-T3  Cards 


Only  one  Tl,  T2,  and  T3  card  can  be  used. 


Chemical  reaction  narameters 

Field  Variable 

Value 

Description 

Cl-2  ICl 

RX 

Card  group  identifier. 

C3  IC3 

1 

Numbers  of  reactions  and  chemicals 

1  NRXN 

+ 

Number  of  reactions. 

2  NCHEM 

+ 

Number  of  dissolved  chemicals. 

Field  Variable  Value  Description 

C  1-2  ICl  RX  Card  group  identifier. 

C  3  IC3  2  Chemical  names 

1  NCHEM  +  Number  of  dissolved  Chemical. 

Note:  NCHEM  new  lines  are  needed. 

(the  first  new  Mne) 

CHEMN(l)  +  Name  of  the  1-st  dissolved  chemical. 

(the  second  new  line) 

CHEMN(2)  +  Name  of  the  2-nd  dissolved  chemical. 

(the  NCHEM-th  new  line) 

CHEMN(NCHEM)  +  Name  of  the  NCHEM-th  dissolved  chemical. 

Field  Variable  Value  Description 

C  1-2  ICl  RX  Card  group  identifier. 

C  3  IC3  3  Reaction  rate  constants  and  stoichiometry 

1  j  +  id  of  chemical  reaction. 

2  NCHEM  +  Number  of  dissolved  chemicals. 

3  FKRX(j)  +  Forward  reaction  rate  constant  of  the  reaction,  [reaction  dependent] 

4  BKRX(j)  +  Backward  reaction  rate  constant  of  the  reaction,  [reaction 

dependent] 

Note:  Two  new  lines  are  needed. 

(the  first  new  line) 

1  NURTS(j,l)  +  Stoichiometric  coefficient  of  the  1-st  dissolved  chemical  (on  the 

reactant  side)  in  the  reaction. 

2  NURTS(j,2)  +  Stoichiometric  coefficient  of  the  2-nd  dissolved  chemical  (on  the 
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reactant  side)  in  the  reaction. 

up  to  NURTS(j,NCHEM) 

(the  second  new  line) 

1  NUPDS(j,l)  +  Stoichiometric  coefficient  of  the  1-st  dissolved  chemical  (on  the 

product  side)  in  the  reaction. 

2  NUPDS(j,2)  +  Stoichiometric  coefficient  of  the  2-nd  dissolved  chemical  (on  the 

product  side)  in  the  reaction. 

up  to  NUPDSG,NCHEM) 


ST  card 

Sediment  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

ST 

Card  group  identifier. 

C3 

IC3 

1 

Number  of  sediment  sizes 

1 

NSSIZE 

+ 

Number  of  sediment  sizes. 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

ST 

Card  group  identifier. 

C3 

IC3 

2 

Parameter  associated  with  each  sediment  size. 

1 

j 

+ 

id  of  Sediment  size. 

2 

SPARA(j,l) 

1 

The  type  of  the  sediment  size. 

Cohesive  sediment,  e.g.,  clay  and  silt. 

2 

Non-cohesive  sediment,  e.g.,  sand. 

3 

SPARAO',2) 

+ 

Settling  speed  of  the  sediment  size.  [L/T] 

4 

SPARA(j,3) 

+ 

Critical  shear  stress  for  deposition  of  the  sediment  size.  [M/L/T^] 

5 

SPARAa,4) 

+ 

Critical  shear  stress  for  erosion  of  the  j-th  size  fraction  of 
sediment.  [M/L/T^] 

6 

SPARA(j,5) 

+ 

Erodibility  of  the  sediment  size.  [M/L^] 

7 

SPARA(j,6) 

+ 

Specific  weight  of  the  sediment  size.  [M/L^] 

8 

SPARA(j,7) 

+ 

Median  diameter  of  particles  in  mixture  of  the  sediment  size.  [L] 

9 

SPARA(j,8) 

+ 

Critical  bottom  shear  stress  of  the  sediment  size  at  which  sediment 
movement  begins.  [M/L/T^] 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

ST 

Card  group  identifier. 

C3 

IC3 

3 

Sorption  rate  constants  and  stoichiometry  related  to  suspended 
sediment. 

1 

j 

+ 

id  of  suspended  sediment  size. 

2 

i 

+ 

id  of  dissolved  chemical. 

3  FKSPSSO,!) 

+ 

Forward  rate  constant  of  the  sorption  of  i-th  dissolved  chemical 

onto  the  suspended  sediment  of  the  j-th  size.  [L^/M/T] 

4  BKSPSS(j,2) 

+ 

Backward  rate  constant  of  the  sorption  of  i-th  dissolved  chemical 

onto  the  suspended  sediment  of  the  j-th  size.  [1/T] 
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Field 

Variable 

Value 

Description 

C  1-2 

ICl 

ST 

Card  group  identifier. 

C3 

IC3 

4 

Sorption  rate  constants  and  stoichiometry  related  to  bed  sediment. 

1 

j 

+ 

id  of  bed  sediment  size. 

2 

i 

+ 

id  of  dissolved  chemical. 

3  FKSPBSO,!) 

+ 

Forward  rate  constant  of  the  sorption  of  i-th  dissolved  chemical 

onto  the  bed  sediment  of  the  j-th  size.  [L^/M/T] 

4  BKSPBS(j,2) 

+ 

Backward  rate  constant  of  the  sorption  of  i-th  dissolved  chemical 

onto  the  bed  sediment  of  the  j-th  size.  [1/T] 

VO  card 

Volatilization  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

VO 

Card  group  identifier. 

C3 

IC3 

1 

Volatilization  rate  constants. 

1 

j 

+ 

id  of  dissolved  chemical. 

2 

lAPO) 

+ 

id  of  xy  series  to  describe  the  partial  atmospheric  pressure  profile 
of  the  dissolved  chemical,  [atm] 

3 

FKVO(j) 

+ 

Forward  volatilization  rate  constant  of  the  dissolved  chemical. 
[1/T] 

4 

BKVO(j) 

+ 

Backward  volatilization  rate  constant  of  the  dissolved  chemical. 
[M/atm/L^/T] 

DYcard 

1  -St  order  decav  parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

DY 

Card  group  identifier. 

C3 

IC3 

1 

Decay  constants  of  dissolved  chemicals. 

1 

j 

+ 

id  of  dissolved  chemical. 

2 

DECAY(j) 

+ 

1-st  order  decay  constant  of  the  dissolved  chemical.  [1/T] 

Esld 

Variable 

Value 

Description 

C  1-2 

ICl 

DY 

Card  group  identifier. 

C3 

IC3 

2 

Decay  constants  of  particulate  chemicals  on  suspended  sediments. 

1 

j 

+ 

id  of  sediment  size. 

2 

i 

+ 

id  of  particulate  chemical. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 

4 

DCY 

+ 

Decay  constant  of  the  particulate  chemical  on  the  suspended 
sediment.  [1/T] 

Eifild 

Variable 

Value 

Description 

C  1-2 

ICl 

DY 

Card  group  identifier. 

C3 

IC3 

3 

Decay  constants  of  particulate  chemicals  on  bed  sediments. 

1 

j 

+ 

id  of  sediment  size. 

2 

i 

+ 

id  of  particulate  chemical. 

3 

NCHEM 

+ 

Number  of  dissolved  chemicals. 
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4 

NSSIZE 

+ 

Number  of  sediment  sizes. 

5 

DCY 

+ 

Decay  constant  of  the  particulate  chemical  on  the  bed  sediment. 
[l/T] 

XYX^rd 

X-Y  Series  Parameters 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

XY 

Card  group  identifier. 

C3 

IC3 

1 

Generation  of  any  x-y  series  function. 

1 

i 

+ 

Index  number  for  x-y  series. 

2 

NPOINT(i) 

+ 

The  number  of  x-y  values  in  the  series. 

3 

DELTAX 

0 

Dummy  values. 

4 

DELTAY 

0 

Dummy  values. 

5 

REPEAT 

0 

Dummy  values. 

6 

BEGCYC 

0 

Dummy  values. 

7 

TNAME 

+ 

A  character  string  representing  the  name  of  the  XY  series. 

(new  line)X,Y 

After  XY  card,  the  x-y  values  of  the  series  are  listed  one  pair  per 

line  up  to  NPOINT(i). 

ENCard 

End  of  data  control 

Field 

Variable 

Value  Description 

Cl-2 

ICl 

EN 

Card  group  identifier. 

C3 

IC3 

D 

End  of  input  data. 

1-D/2D  Mapping  File  (.map  files) 

T1-T3  Cards 

Job  title 

Only  one  Tl,  T2,  and  T3  card  can  be  used. 

CO  Card 

Field 

Variable 

Value 

Description 

C  1-2 

ICl 

CO 

Card  group  identifier. 

C3 

IC3 

1 

River/stream-related  overland  nodes 

1 

N 

+ 

id  of  global  river/stream  node. 

2 

NP12(N) 

+ 

id  of  the  global  overland  node  that  is  associated  with  the  global 
river/stream  node.  This  overland  node  will  be  excluded  in  overland 
simulations. 

3 

NPS12(1,N) 

+ 

id  of  the  global  overland  node  that  serves  as  the  1-st  overland  node 
next  to  the  global  river/stream  node.  This  overland  node  is  treated  as 
a  boundary  node  for  overland  simulations. 

4 

NPS12(2,N) 

+ 

id  of  the  global  overland  node  that  serves  as  the  2-nd  overland  node 
next  to  the  global  river/stream  node.  This  overland  node  is  treated  as 
a  boundary  node  for  overland  simulations. 

ENCard 

End  of  data  control 
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u  u 


Field  Variable  Value  Dj 

1-2  ICl  EN  Card  group  identifier. 

3  ICS  D  End  of  input  data. 

Table  1.1  lists  necessary  parts  for  undergoing  different  simulations. 


Table  1.1  Data  files  required  to  achieve  numerical  simulations. 


Simulations 

Files  required 

1-D  river/stream  flow 

Files  4  and  5 

1-D  river/stream  transport 

Files  4, 5,  6,  and  7 

1-D  river/stream  flow  and  transport 

Files  4, 5, 6,  and  7 

2-D  overland  flow 

Files  1  and  2 

2-D  overland  transport 

Files  1, 2, 3,  and  7 

2-D  overland  flow  and  transport 

Files  1, 2,  3,  and  7 

1-D/2-D  flow 

Files  1, 2, 4,  5,  and  8 

1-D/2-D  flow  and  transport 

Files  1  through  8 
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APPENDIX  B  PROGRAM  STRUCTURE  AND  SUBROUTINE  DESCRIPTION 

In  this  appendix,  we  are  to  give  plots  showing  the  structure  of  the  computer  program  and 
provide  description  for  each  subroutine. 


Program  Structure 
1 

MAIN  and  the  subroutines/functions  it  calls  to. 
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Subroutine  FILES_1  and  the  subroutines/functions  it  calls  to, 
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Subroutine  FILES_2  and  the  subroutines/functions  it  calls  to. 
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Subroutine  FLOW_l  and  the  subroutines/functions  it  calls  to. 
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Subroutine  TRANSP_1  and  the  subroutines/functions  it  calls. 
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Subroutine  TRANSP_2  and  the  subroutines/functions  it  calls  to. 
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Subroutine  FLOW2MOC  and  the  subroutines/functions  it  calls. 


GAUPNT_2 


GAUPNT_2 
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Subroutine  BTRAKF  1  and  the  subroutines/functions  it  calls  to. 


Subroutine  BTRAKF_2  and  the  subroutines/functions  it  calls  to. 
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Subroutine  BTRAKT_1  and  the  subroutines/functions  it  calls  to. 
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Subroutine  BTRAKF2M  and  the  subroutines/functions  it  calls  to. 


Subroutine  GWID  1  and  the  subroutines/fimctions  it  calls  to. 


Subroutine  GW1D_2  and  the  subroutines/functions  it  calls  to. 
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Subroutine  Description 
MAIN 


This  main  program  serves  the  purpose  of  controlling  the  flow  path  of  desired  simulations. 
It  calls  to  Subroutines  FILES_2  and  FILES_1  to  read  in  necessary  data  to  undergo  numerical 
simulations.  It  calls  to  Subroutines  FLOW_2  or  FLOW2MOC  to  compute  2-D  overland  flow. 
Subroutine  TRANSP_2  to  calculate  2-D  overland  transprot,  Subroutine  FLOW_l  to  compute  1-D 
river/stream  flow,  and  Subroutine  TRANSP_1  to  calculate  1-D  river/stream  transport.  It  also  calls 
to  Subroutine  FLUX02C  to  estimate  both  water  and  material  flow  rates  from  overland  into 
river/stream,  and  vice  versa.  In  addition,  it  calls  to  needed  subroutines  to  print  or  store  numerical 
results,  including  water  depth,  stage,  discharge,  velocity,  and  concentration,  at  desired  times. 

Subroutine  ADVBCF_1 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian 
step  of  solving  the  1-D  flow  equations.  In  this  subroutine,  boundary  conditions  with  either  water 
depth  or  upstream  inflow  specified  are  implemented  to  obtain  water  depth  at  associated  boundary 
nodes.  In  addition,  Dirichlet-type  boundary  conditions  are  applied  to  junction-connected  river  or 
stream  nodes. 

Subroutine  ADVBCF_2 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian 
step  of  solving  the  2-D  flow  equations.  In  this  subroutine,  boundary  conditions  with  either  water 
depth  or  upstream  inflow  specified  are  implemented  to  obtain  water  depth  at  associated  boundary 
nodes.  At  the  river/stream-  and  junction-related  nodes,  the  flow  direction  is  from  river/stream  or 
junction  to  the  interior  of  overland,  the  flux  is  estimated  and  the  corresponding  water  depth  is 
calculated  accordingly. 

Subroutine  ADVBCF2M 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian 
step  of  solving  the  2-D  flow  equations  when  the  method  of  characteristics  is  applied.  In  this 
subroutine,  boundary  conditions  with  either  water  stage  or  upstream  inflow  specified  are 
implemented  to  obtain  water  stage  or  normal  flux,  respectively,  at  associated  boundary  nodes.  At 
the  river/stream-  and  junction-related  nodes,  the  flow  direction  is  from  river/stream  or  junction  to 
the  interior  of  overland,  the  normal  flux  is  estimated  at  the  corresponding  boundary  nodes. 

Subroutine  ADVBCT_1 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian 
step  of  solving  the  1-D  transport  equations  of  (1)  suspended  sediment,  (2)  dissolved  chemicals,  and 
(3)  particulate  chemicals  on  suspended  sediments.  Since  the  diffusive  flux  is  neglected  in  the 
Lagrangian  Step,  only  are  the  Dirichlet,  Cauchy,  and  variable  boxmdaiy  conditions  are  applied.  In 
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addition,  Dirichlet-type  boundary  conditions  are  applied  to  junction-connected  river/stream  nodes. 

Subroutine  ADVBCT_2 

This  subroutine  is  to  implement  boundary  conditions  for  the  computation  in  the  Lagrangian 
step  of  solving  the  2-D  transport  equations  of  (1)  suspended  sediment,  (2)  dissolved  chemicals,  and 
(3)  particulate  chemicals  on  suspended  sediments.  Since  the  diffusive  flux  is  neglected  in  the 
Lagrangian  Step,  only  are  the  Dirichlet,  Cauchy,  and  variable  boundary  conditions  are  applied.  In 
addition.  Variable-type  boundary  conditions  are  applied  to  river/stream-  and  Junction-related 
overland  nodes  if  flow  direction  is  determined  from  river/stream/junction  to  overland. 

Subroutine  ADWK_1 

This  subroutine  is  to  determine  the  working  arrays  of  coordinates  (XW)  and  velocities 
(VXW)  in  the  element  being  considered  in  order  to  perform  the  1-D  “in-element”  particle  tracking. 

Subroutine  ADWK_2 

This  subroutine  is  to  determine  the  working  arrays  of  coordinates  (XW),  velocities  (VXW), 
subelement  indices  (BEW),  and  element  boundary  index  (IBW)  in  the  element  being  considered  in 
order  to  perform  the  2-D  “in-element”  particle  tracking. 

Subroutine  ALGBY_2 

This  subroutine  is  to  achieve  particle  tracking  along  the  2-D  unspecified  boundary.  Water 
flow  is  considered  parallel  to  the  boundary  on  the  specified  boundary.  This  subroutine  also  considers 
the  first-order  growth/decay  term  along  characteristics. 

Subroutine  ALGB  YF2M 

This  subroutine  is  to  achieve  particle  tracking  along  the  2-D  unspecified  boundary.  Water 
flow  is  considered  parallel  to  the  boundary  on  the  specified  boundary.  It  is  used  only  when  the 
method  of  characteristics  is  employed  to  solve  the  2-D  flow  equation. 

Subroutine  AREA 

This  subroutine  is  to  compute  the  area  of  a  2-D  element. 

Subroutine  ASEMBF2M 

This  subroutine  is  to  compose  the  global  matrix  equation  to  adjust  2-D  velocity  in  the  last 
part  of  the  method  of  characteristic  approach  when  eddy  viscosity  is  taken  into  account. 

Subroutine  ASEMBT_1 
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This  subroutine  is  to  compute  coefficient  matrices  CMATRXl  and  CMATRX2  for  1-D 
transport  equations.  CMATRXl  is  a  mass  matrice  that  takes  into  account  the  total  time  derivative 
term,  while  CMATRX2  is  stiffness  matrice  that  considers  the  dispersion  term. 

Subroutine  ASEMBT_2 

This  subroutine  is  to  compute  coefficient  matrices  CMATRXl  and  CMATRX2  for  2-D 
transport  equations.  CMATRXl  is  a  mass  matrice  that  takes  into  account  the  total  time  derivative 
term,  while  CMATRX2  is  stiffness  matrice  that  considers  the  dispersion  term. 

Subroutine  ASOLV2M 

This  subroutine  is  to  constmct  and  solve  a  set  of  three  algebraic  equations  (Eqs.  (3.133) 
through  (3.135))  that  is  formed  by  using  the  method  of  characteristics  to  solve  the  dynamic  wave 
model. 

Subroutine  BANSOL 

This  subroutine  is  to  solver  matrix  equations  with  a  direct  band  solver.  When  the  first 
argument  is  set  to  1,  the  subroutine  triangularize  the  band  coefficient  matrice.  When  the  argument 
is  set  to  2,  the  subroutine  solves  for  the  solution  (back  substitution). 

Subroutine  BASE_21 

This  subroutine  is  to  compute  the  shape  functions  and  their  derivatives  at  a  point  located  in 
a  quadrilateral  element,  given  the  local  coordinates  at  the  point. 

Subroutine  BASE_22 

This  subroutine  is  to  compute  the  shape  functions  at  a  point  located  in  a  2-D  element  (either 
triangular  or  quadrilateral),  given  the  Cartesian  coordinates  both  at  the  point  and  element  nodes. 

Subroutine  BCGW_1 

This  subroutine  is  to  implement  boundary  conditions,  including  Cauchy,  Neumann,  and 
Diiichlet  types,  for  the  river/stream  node-associated  1-D  vertical  subsurface  flow. 

Subroutine  BCGW_2 

This  subroutine  is  to  implement  boundary  conditions,  including  Cauchy,  Neumann,  and 
Dirichlet  types,  for  the  overland  node-associated  1-D  vertical  subsurface  flow. 

Subroutine  BCT_1 
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This  subroutine  is  to  implement  boundary  conditions,  including  Dirichlet,  Cauchy,  Neumann, 
conventional  variable,  and  junction-related  variable  types,  for  1-D  river/stream  transport.  All 
boundaiy  conditions,  except  for  the  junction-related  variable  type,  are  specified  at  boundary  nodes 
(or  reach  ends)  with  time-dependent  profiles.  For  junction-connected  nodes,  junction-related 
variable  boundary  conditions  are  applied. 

Subroutine  BCT_2 

This  subroutine  is  to  implement  boundary  conditions,  including  Dirichlet,  Cauchy,  Neumann, 
conventional  variable,  and  river/stream-related  or  junction-related  variable  types,  for  2-D  river  or 
stream  transport.  Dirichlet  boundary  conditions  are  specified  at  boundaiy  nodes,  while  the  other 
types  of  boundary  conditions  are  categorized  as  flux-type  boundary  conditions  and  are  specified  on 
boundary  sides.  Dirichlet,  Cauchy,  Neumann,  and  conventional  variable  boundary  conditions  are 
prescribed  with  time-dependent  profiles,  while  river/stream-  or  junction-related  variable  boundary 
conditions  are  applied  to  their  associated  boundary  sides. 

Subroutine  BSHEAR_1 

This  subroutine  is  to  achieve  the  calculation  of  bottom  shear  stress  at  all  river/stream  nodes. 

Subroutine  BSHEAR_2 

This  subroutine  is  to  achieve  the  calculation  of  bottom  shear  stress  at  all  overland  nodes. 

Subroutine  BTRAKF_1 

This  subroutine  is  implement  backward  particle  tracking  to  obtain  the  water  depth  at  all  1-D 
global  nodes.  Since  a  first-order  approach  is  used  for  both  kinematic  and  diffusion  models  and  all 
source/sink  rate  terms  can  be  expressed  a  linear  function  of  water  depth,  we  thus  take  into  account 
the  first-order  decay/growth  rate  along  the  characteristics  when  we  implement  backward  particle 
tracking.  As  for  the  zeroth-order  source/sink  rate,  we  simply  multiply  this  rate  by  the  time-step  size 
being  considered  and  add  the  product  to  the  outcome  of  backward  particle  tracking. 

Subroutine  BTRAKF_2 

This  subroutine  is  implement  backward  particle  tracking  along  three  characteristics  to  obtain 
the  Lagrangian  water  depth  and  veloctiy  at  all  2-D  global  nodes  when  the  method  of  characteristics 
is  used  to  solve  2-D  flow  equations.  The  spatial  reachout  approach  is  currently  implemented  in  this 
subroutine. 

Subroutine  BTRAKF2M 

This  subroutine  is  implement  backward  particle  tracking  to  obtain  the  water  depth  at  all  2-D 
global  nodes.  Since  a  first-order  approach  is  used  for  both  kinematic  and  diffusion  models  and  all 
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source/sink  rate  terms  can  be  expressed  a  linear  function  of  water  depth,  we  thus  take  into  account 
the  first-order  decay/growth  rate  along  the  characteristics  when  we  implement  backward  particle 
tracking.  As  for  the  zeroth-order  source/sink  rate,  we  simply  multiply  this  rate  by  the  time-step  size 
being  considered  and  add  the  product  to  the  outcome  of  backward  particle  tracking. 

Subroutine  BTRAKT_1 

This  subroutine  is  implement  backward  particle  tracking  to  obtain  the  Lagrangian  values  of 
concentrations  of  (1)  dissolved  chemicals,  (2)  suspended  sediments,  and  (3)  particulate  chemicals 
on  suspended  sediments  at  all  1-D  global  nodes. 

Subroutine  BTRAKT_2 

This  subroutine  is  implement  backward  particle  tracking  to  obtain  the  Lagrangian  values  of 
concentrations  of  (1)  dissolved  chemicals,  (2)  suspended  sediments,  and  (3)  particulate  chemicals 
on  suspended  sediments  at  all  2-D  global  nodes. 

Subroutine  CHNGSN 

This  subroutine  is  to  change  sign  of  the  velocities  at  point  P  (the  starting  location),  point  Q 
(the  ending  location),  and  working  subelement  nodes  in  the  process  of  2-D  or  3-D  “in-element” 
particle  tracking. 

Subroutine  CKCNEL_2 

This  subroutine  is  to  determine  the  element  that  connects  to  a  specified  element  through  the 
element  side  with  the  N  1-th  and  N2-th  global  nodes  serving  as  the  two  end  nodes  of  the  side. 

Subroutine  CKCOIN_2 

This  subroutine  is  to  determine  whether  or  not  a  specific  node  coincides  with  the  N  1-th 
global  node  or  the  N2-th  global  node. 

Subroutine  COMAP 

This  subroutine  is  to  relate  1-D  river/stream  nodes  with  2-D  overland  nodes.  Those  overland 
nodes  which  correspond  to  river/stream  nodes  will  not  be  taken  into  account  in  2-D  overland 
simulations. 

Subroutine  COORDG_l 

This  subroutine  is  to  determine  the  coordinates  of  nodes  for  simulations  of  the  river/stream 
node-associated  1-D  vertical  subsurface  flow  based  on  given  specification. 
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Subroutine  COORDG_2 


This  subroutine  is  to  determine  the  coordinates  of  nodes  for  simulations  of  the  overland  node- 
associated  1-D  vertical  subsurface  flow  based  on  given  specification. 

Subroutine  CRACKD 

This  subroutine  is  to  read  real  numbers  in  order  from  a  line  data  record. 


Subroutine  CRACKI 

This  subroutine  is  to  read  integer  numbers  in  order  from  a  line  data  record. 

Subroutine  C2JT 

This  subroutine  is  to  compute  the  flow  rate  of  (1)  water  (ED  =  1),  (2)  dissolved  chemicals  (ED 
=  2),  (3)  particulate  chemicals  on  suspended  sediments  ( ED  =  3),  and  (4)  particulate  chemicals  on 
bed  sediments  (ED  =  4)  from  junction-coimected  river/streams  to  a  specified  junction. 

Subroutine  DEPERO_l 


This  subroutine  is  to  compute  the  deposition  and  erosion  rates  either  at  a  river/stream  node 
(when  NP  is  not  zero  and  J  is  zero)  or  at  a  junction  (when  NP  equals  zero  and  J  is  not  equal  to  zero). 
Both  cohesive  and  non-cohesive  cases  are  taken  into  account.  The  following  equations  are  used  to 
achieve  the  computation  at  a  river/stream  node. 


(1)  For  cohesive  sediments: 


D_ 


=  V  S 

sn  n 


(n.i) 


R 


n 


(n.2) 


where  is  the  settling  velocity  of  the  n-th  size  fraction  sediment  [E/T];  t  ^is  the  bottom  shear  stress 
or  the  bottom  friction  stress  [M/L/T^];  is  the  critical  shear  stress  for  the  deposition  of  the  n-th 
size  fraction  sediment  [M/L/T^];  is  the  critical  shear  stress  for  the  erosion  of  the  n-th  size  fraction 
sediment  [M/L/T^];  E„  is  the  erodibility  of  the  n-th  size  fraction  sediment  [M/L^].  In  the  computer 
code,  Vs„,  TcDn>  "tcRn’  ^ud  E„  are  input  parameters,  while  is  computed  in  the  flow  module. 


(2)  For  non-cohesive  sediments: 
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G  “G  A 

R  =  _i£ - (n.4) 

“  AL 

where  GjAd  is  the  actual  load  rate  of  the  n-th  size  fraction  sediment  per  unit  width  at  a  upstream 
location  [M/L/T];  Gjn  is  the  maximum  load  rate  (capacity)  of  the  n-th  size  fraction  sediment  per  unit 
width  at  a  downstream  location  [M/L/T];  AL  is  the  distance  between  the  upstream  and  the 
downstream  locations.  In  the  computer  code,  AL  can  be  determined  based  on  the  coordinates,  while 
Gj^  and  G^^  are  computed  based  on  the  following  equations. 

G3An  =  Sn*u*r  (n.5) 
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where  p  is  the  fluid  density  [M/L^];  is  the  density  of  the  n-th  size  fraction  sediment  [M/L^];  u  is 
river/stream  flow  velocity  [L/Tj;  r  is  hydraulic  radius  [L];  S  the  friction  slope,  d^  is  the  median 
diameter  of  the  n-th  size  fraction  sediment  particle  [Lj;  g  is  gravity  [L/T^];  is  the  critical  bottom 
shear  stress  of  the  n-th  size  fraction  sediment  at  which  sediment  movement  begins  [M/L/T^].  Among 
these  parameters,  p,  p^^,  d„,  and  are  input  by  users,  while  u,  r,  and  S  are  estimated  in  the  flow 
module. 


To  estimate  the  deposition  and  erosion  rates  at  a  junction,  the  following  weighted-average 
equations  are  employed. 


D„(J)  = 
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where  D„(J)  and  R„(j)  are  the  deposition  and  erosion  rate  at  the  J-th  junction;  Uj,  Pj,  D^,  are  the 
velocity,  wetted  perimeter,  deposition  rate,  and  erosion  rate  at  the  river/stream  node  that  serves  as 
the  i-th  junction-connected  node  to  the  J-th  jimction;  NJRTH(J)  is  number  of  river/stream  reaches 
that  are  connected  to  the  J-th  junction. 


Subroutine  DEPERO_2 


This  subroutine  is  to  compute  the  deposition  and  erosion  rates  at  an  overland  node.  The 
equations  described  in  Subroutine  DEPERO_l  are  also  used  here. 
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Subroutine  DGELG 


This  subroutine  is  to  solve  matrix  equations  by  a  direction  solver  incorporated  with  full- 
pivoting. 

Subroutine  DISPC_1 

This  subroutine  is  to  compute  dispersion  coefficients  for  1-D  transport  simulations.  The 
coefficient  is  evaluated  at  every  quadrature  node  of  elements. 

Subroutine  DISPC_2 

This  subroutine  is  to  compute  dispersion  coefficients  for  2-D  transport  simulations.  The 
coefficient  is  evaluated  at  every  quadrature  node  of  elements. 

Subroutine  DISQ 

This  subroutine  is  to  compute  discharge,  based  on  the  computed  results,  for  printing  or 
storing  purposes. 

Function  DOTPRD 

This  function  is  to  compute  the  irmer  product  of  two  given  vectors. 

Subroutine  ELENOD_2 

This  subroutine  is  to  determine  the  number  of  element  nodes  for  a  specified  element. 

Subroutine  ELTRK_1 

This  subroutine  is  to  implement  the  1-D  “in-element”  particle  tracking  for  a  particle  with  its 
starting  location  specified.  During  the  tracking  process,  many  elements  can  be  passed  through.  The 
first-order  growth/decay  term  is  also  taken  into  account  in  the  tracking. 

Subroutine  ELTRK_2 

This  subroutine  is  to  implement  the  2-D  “in-element”  particle  tracking  in  a  specified  element. 
The  first-order  growth/decay  term  is  also  taken  into  account  in  the  tracking. 

Subroutine  ELTRK2M 

This  subroutine  is  to  implement  the  2-D  “in-element”  particle  tracking  in  a  specified  element. 
It  is  used  only  when  the  method  of  characteristics  is  used  to  solve  the  2-D  flow  equation. 
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Subroutine  EQGENT_1 


This  subroutine  is  to  generate  matrix  equations  for  1-D  transport  simulations.  When  IDC  = 
0,  it  is  for  the  transport  of  the  IDS-th  suspended  sediment.  When  IDS  =  0,  it  is  for  the  transport  of 
the  IDC-th  dissolved  chemical.  When  neither  IDC  nor  IDs  equals  zero,  it  is  for  the  IDC-th 
particulate  chemical  on  the  IDS-th  suspended  sediment. 

Subroutine  EQGENT_2 

This  subroutine  is  to  generate  matrix  equations  for  2-D  transport  simulations.  When  IDC  = 
0,  it  is  for  the  transport  of  the  IDS-th  suspended  sediment.  When  IDS  =  0,  it  is  for  the  transport  of 
the  IDC-th  dissolved  chemical.  When  neither  IDC  nor  IDs  equals  zero,  it  is  for  the  IDC-th 
particulate  chemical  on  the  IDS-th  suspended  sediment. 

Subroutine  FACE02C 

This  subroutine  is  to  determine  those  overland  boundary  sides  which  are  either  river/stream- 
related  or  junction-related. 

Subroutine  FASEMGWl 

This  subroutine  is  to  assemble  matrix  equations  for  computing  the  river/stream  node- 
associated  1-D  vertical  subsurface  flow. 

Subroutine  FASEMGW2 

This  subroutine  is  to  assemble  matrix  equations  for  computing  the  overland  node-associated 
1-D  vertical  subsurface  flow. 

Function  FCOS_2 

This  is  to  determine  the  direction  of  the  outer  product  of  two  vectors. 

Subroutine  FILES_1 

This  subroutine  is  to  read  in  information  in  order  to  perform  1-D  river/stream  simulations. 
The  information  includes  (1)  geometry  data,  (2)  flow  simulation  data,  and  (3)  transport  simulation 
data. 

Subroutine  FILES_2 

This  subroutine  is  to  read  in  information  in  order  to  perform  2-D  river/stream  simulations. 
The  information  includes  (1)  geometry  data,  (2)  flow  simulation  data,  and  (3)  transport  simulation 
data. 
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Subroutine  F1XCKF_2 


This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  2-D  water  flow  when  a 
particle  encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the  current 
particle  tracking  stops  here  and  interpolated  is  employed  to  compute  the  Lagrangian  value.  If  this 
boundary  is  unspecified  (closed),  on  the  other  hand,  the  flow  direction  is  parallel  to  the  boundary  and 
particle  tracking  along  the  boundary  proceeds  until  either  the  available  tracking  time  is  completely 
consumed  or  a  specified  boundary  is  reached.  The  first-order  growth/decay  term  is  also  taken  into 
account  in  the  tracking. 

Subroutine  FIXCKF2M 

This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  2-D  water  flow  when  a 
particle  encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the  current 
particle  tracking  stops  here  and  interpolated  is  employed  to  compute  the  Lagrangian  value.  If  this 
boundary  is  unspecified  (closed),  on  the  other  hand,  the  flow  direction  is  parallel  to  the  boundary  and 
particle  tracking  along  the  boundary  proceeds  until  either  the  available  tracking  time  is  completely 
consumed  or  a  specified  boundary  is  reached.  It  is  used  only  when  the  method  of  characteristics  is 
employed  to  solve  the  2-D  flow  equation. 

Subroutine  FIXCKT_2 

This  subroutine  is  to  handle  the  case  in  the  particle  tracking  of  2-D  chemical  transport  when 
a  particle  encounters  the  boundary.  If  this  boundary  is  a  specified  (flow-through)  boundary,  the 
current  particle  tracking  stops  here  and  interpolated  is  employed  to  compute  the  Lagrangian  value. 
If  this  boundary  is  unspecified  (closed),  on  the  other  hand,  the  flow  direction  is  parallel  to  the 
boimdary  and  particle  tracking  along  the  boundary  proceeds  imtil  either  the  available  tracking  time 
is  completely  consumed  or  a  specified  boundary  is  reached. 

Function  FKAPA_2 

This  function  is  to  compute  the  bottom  friction  coefficient,  k,  as  defined  as  follows. 

gn|V(h^Z„)f^^[l^(VZ„)^f 


Subroutine  FKK1_1 

This  subroutine  is  to  compute  the  flow  velocity  at  global  nodes  for  either  the  kinematic  model 
or  the  diffusion  model  of  1-D  river/stream  flow. 

Subroutine  FKK1_2 

This  subroutine  is  to  compute  the  flow  velocity  at  global  nodes  for  either  the  kinematic  model 
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or  the  diffusion  model  of  2-D  overland  flow. 


Subroutine  FKK2_1 

This  subroutine  is  to  compute  the  source/sink  term  at  a  global  node  due  to  non-uniform  bed 
slope  or  potential  slope  for  the  kinematic  model  or  the  diffusion  model,  respectively,  of  1-D 
river/stream  flow. 

Subroutine  FKK2_2 

This  subroutine  is  to  compute  the  source/sink  term  at  a  global  node  due  to  non-uniform  bed 
slope  or  potential  slope  for  the  kinematic  model  or  the  diffusion  model,  respectively,  of  2-D  overland 
flow. 

Subroutine  FLOW_l 

This  subroutine  serves  as  the  control  panel  of  computing  1-D  river/stream  flow  by  using  the 
Lagrangian  approach  to  solve  the  diffusion  model.  The  Picard  method  is  used  to  deal  with 
nonlinearity.  During  each  nonlinear  iteration,  the  working  velocity  is  first  estimated  based  on  the 
working  water  depth  with  Eq.  (2.3).  This  working  velocity  is  then  used  to  achieve  backward  particle 
tracking  in  the  Lagrangian  approach  to  obtain  the  updated  water  depth.  Convergence  is  determined 
by  checking  the  maximum  relative  error  of  water  depth.  Relaxation  technique  is  applied  to  update 
the  working  water  depth  for  the  next  iteration  if  convergence  has  not  been  reached.  When  junctions 
exist,  water  budget  is  employed  to  determine  the  water  depth  at  junctions.  The  flow  rates  of  water 
coming  from  or  going  into  the  jimction-connected  reaches  are  calculated  based  on  the  working 
velocity  and  cross-sectional  areas  at  junction-reach  interfacial  nodes  (e.g..  Nodes  10, 13,  and  32  in 
Figure  4.4). 

Subroutine  FLOW_2 

This  subroutine  serves  as  the  control  panel  of  computing  2-D  overland  flow  by  using  the 
Lagrangian  approach  to  solve  the  diffusion  model.  The  Picard  method  is  used  to  deal  with 
nonlinearity.  During  each  nonlinear  iteration,  the  working  velocity  is  first  estimated  based  on  the 
working  water  depth  with  Eqs.  (2.12)  and  (2.13).  This  working  velocity  is  then  used  to  achieve 
backward  particle  tracking  in  the  Lagrangian  approach  to  obtain  the  updated  water  depth. 
Convergence  is  determined  by  checking  the  maximum  relative  error  or  water  depth.  Relaxation 
technique  is  applied  to  update  the  working  water  depth  for  the  next  iteration  if  convergence  has  not 
been  reached. 

Subroutine  FLOW2MOC 

This  subroutine  serves  as  the  control  panel  of  computing  2-D  overland  flow  by  using  the 
method  of  characteristics  to  solve  the  dynamic  model.  The  Picard  method  is  used  to  deal  with 
nonlinearity.  During  each  nonlinear  iteration.  The  characteristic  equations  (Eq.  (3.100))  are  solved 
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first  by  the  backward  particle  tracking  along  three  characteristics.  After  H*,  if ,  and  V  are 
determined,  we  compute  H,  u,  and  v  by  solving  Eqs.  (3.147)  through  (3.149).  Convergence  is 
determined  by  checking  the  maximum  relative  error  of  H,  u,  and  v.  Relaxation  technique  is  applied 
to  update  the  working  water  stage  and  velocity  for  the  next  iteration  if  convergence  has  not  been 
reached. 

Subroutine  FLUX02C 

This  subroutine  is  to  compute  flow  rate  of  water,  dissolved  chemicals,  suspended  sediments, 
and  particulate  chemicals  on  suspended  sediments  from  overland  to  both  river/stream  nodes  and 
river/stream  junctions.  When  the  outward  normal  velocity  is  positive  at  a  river/stream-  or  junction- 
related  overland  boundary  node,  there  is  water  flowing  from  overland  to  the  associated  river/stream 
node  or  junction.  If  the  outward  normal  velocity  is  negative,  two  cases  are  taken  into  account:  when 
the  associated  liver/stream/junction  water  stage  is  higher  than  the  bottom  elevation  of  this  overland 
boundary  node,  there  is  water  flowing  from  river/stream/junction  to  overland:  otherwise,  there  is 
no  water  passing  through  the  1D-2D  interface. 

Subroutine  FTAUB_1 

This  subroutine  is  to  calculate  bottom  shear  stress  at  a  river/stream  node.  The  following 
equation  is  used  to  achieve  the  computation. 

T  =  pgnr'/3ji^(V2^)2]2/3|y(jj^2o)|i/2u  (n.lO) 

Subroutine  FTAUB_2 

This  subroutine  is  to  calculate  bottom  shear  stress  at  an  overland  node.  The  following 
equations  are  used  to  achieve  the  computation. 

=  pgnh'/'[l+(VZo)"f'|V(h+Zo)f'2^ 

Ty  =  p  gn  h  [l  +(VZo)2]2/3  |V(h  +Zo)f'2  V  (n.l2) 

Subroutine  GAUPNT_2 

This  subroutine  is  to  compute  shape  functions  and  their  derivatives  at  quadrature  nodes. 

Subroutine  GEOGRAD 

This  subroutine  is  to  compute  the  derivatives  of  hydraulic  radius  and  average  river/stream 
width  with  respect  to  distance  and  water  depth  in  1-D  river/stream  flow  simulations. 

Subroutine  GEOMIDC 

This  subroutine  is  to  determine  the  river/stream-associated  overland  elements  that  are  not  to 
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be  taken  into  account  in  2-D  overland  simulations. 


Subroutine  GEOM_l 

This  subroutine  is  to  read  in  1-D  river/stream  geometry,  including  coordinates  and  element 
indices. 

Subroutine  GEOM_2 

This  subroutine  is  to  read  in  2-D  overland  geometry,  including  coordinates  and  element 
indices. 

Subroutine  GEOPREP 

This  subroutine  is  to  prepare  the  profile  of  describing  the  derivatives  of  both  hydraulic  radius 
and  average  river/stream  width  with  respect  to  water  depth,  based  on  the  prescribed  profiles  of 
river/stream  geometry. 

Subroutine  GRAD_1 

This  subroutine  is  to  compute  the  spatial  derivatives  of  water  depth,  stage,  flow  velocity, 
average  river/stream  width,  and  Manning’s  n  as  desired  in  1-D  liver/stream  simulations.  In  addition, 
the  second  spatial  derivatives  of  water  depth  and  stage  are  calculated  as  needed. 

Subroutine  GRAD_2 

This  subroutine  is  to  compute  the  spatial  derivatives  of  water  depth,  stage,  flow  velocity,  and 
Manning’s  n  as  desired  in  2-D  overland  simulations.  In  addition,  the  second  spatial  derivatives  of 
water  depth  and  stage  are  calculated  as  needed. 

Subroutine  GSTORE_l 

This  subroutine  is  to  store  pertinent  quantities  for  post-processing  of  1-D  river/stream 
simulations. 

Subroutine  GSTORE_2 

This  subroutine  is  to  store  pertinent  quantities  for  post-processing  of  2-D  overland 
simulations. 

Subroutine  GW1D_1 

This  subroutine  is  to  control  the  flow  of  computing  the  1-D  vertical  subsurface  flow  that  is 
associated  with  each  river/stream  node. 
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Subroutine  GWID  2 


This  subroutine  is  to  control  the  flow  of  computing  the  1-D  vertical  subsurface  flow  that  is 
associated  with  each  overland  node. 

Subroutine  IBWCHK_2 

This  subroutine  is  to  determine  the  two  global  nodes  that  serve  as  the  two  end  node  of  an 
element  side.  This  element  side  is  the  side  that  the  particle  has  encountered  when  it  passes  through 
the  element  being  considered. 

Subroutine  IDFBS 

This  subroutine  is  to  relate  flux-type  boundary  sides  with  global  boundary  sides.  The 
relationship  is  stored  in  two  arrays:  one  for  flow  simulations  and  the  other  for  transport  simulations. 

Subroutine  ILUCG 

This  subroutine  is  to  solve  the  linearized  matrix  equation  that  is  sparse  asymmetric  with  the 
preconditioned  conjugate  gradient  method  using  the  incomplete  Cholesky  decomposition  as  a 
preconditioner. 

Subroutine  INTRPF_2 

This  subroutine  is  to  determine  the  Lagrangian  water  depth  by  interpolation  after  backward 
particle  tracking  in  solving  flow  governing  equations 

Subroutine  INTRPF2M 


Subroutine  INTRPT_2 

This  subroutine  is  to  determine  the  Lagrangian  chemical  and  suspended  sediment 
concentrations  by  interpolation  after  backward  particle  tracking  in  the  Lagrangian  step  of  solving 
transport  governing  equations 

Subroutine  JACOBI_l 

This  subroutine  is  to  compute  the  Jacobian  for  the  chemical  system  at  the  NP-th  node  (when 
NP  is  not  equal  to  zero  and  J  equals  zero)  or  the  J-th  junction  (when  NP  equals  zero  and  J  is  not 
equal  to  zero).  The  Jacobian  elements  are  defined  as  follows. 

For  the  case  at  the  NP-th  node: 
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(1)  For  dissolved  chemicals: 


dRESC 


a(CiT 


^  =  6„A+6ij6t  XrA+R-I+Ri+R2+Aki*'+£s„Ak^'H-£M„Pk^'  - 


6t  E  l^Ab^(C, n  (Cj'^^-E  k^Aa^CC, JI  (CjT“^ 

m=l  ni=l 

ie[l,Nl 
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aRESC 
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aRESC; 
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(2)  For  particulate  chemicals  on  suspended  sediments: 
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(3)  For  particulate  chemicals  on  bed  sediments: 


aRESC^ 

a(CiT"' 


=  -6„Atk^“M„ 


ne[l,N3],  ie[l,NJ,  k=(n+N^)*N^+i 


(n.l8) 


(n.i9) 


aRESC 


- 1  =  -6i,AtD„ 

SxN*l  ^  ” 


ne[l.N],  i6[l,N],  k  =  (n+N)*N  +i 


(n.20) 


aRESC^ 

a(c^y^' 


=  6iiM  +6.,AtR  +A,AtM„ 

11  n  il  n  11  n 


(n.2i) 


ne[l,N],  ie[l,N],  k=(n+NJ*N  +i 


Appendix  B-26 


(1)  For  dissolved  chemicals: 
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(2)  For  particulate  chemicals  on  suspended  sediments: 
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(3)  For  particulate  chemicals  on  bed  sediments: 
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Subroutine  JACOBI_2 
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This  subroutine  is  to  compute  the  Jacobian  for  the  chemical  system  at  the  NP-th  node.  The 
Jacobian  elements  are  defined  as  follows. 

(1)  For  dissolved  chemicals: 
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(2)  For  particulate  chemicals  on  suspended  sediments: 
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(3)  For  particulate  chemicals  on  bed  sediments: 
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aRESQc) 


=  §aM„-^6,AtR„  +  6aAtM„ 
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Subroutine  JUNCTION 

This  subroutine  is  to  update  water  depths  (stages)  at  junctions  based  on  the  concept  of  water 

budget. 

Subroutine  KXKY_2M 

This  subroutine  is  to  determine  characteristic  directions  at  a  2-D  global  node  for  overland 
flow  simulations,  based  on  the  velocity,  the  spatial  velocity  derivatives,  and  the  spatial  stage 
derivatives  at  the  node.  This  subroutine  is  needed  only  when  the  method  of  characteristics  is 
employed  to  solve  the  2-D  flow  equation. 

Subroutine  KXKYNP2M 

This  subroutine  is  to  determine  characteristic  directions  at  all  2-D  global  nodes  for  overland 
flow  simulations.  This  subroutine  is  needed  only  when  the  method  of  characteristics  is  employed 
to  solve  the  2-D  flow  equation. 

Subroutine  LINEAR 

This  subroutine  is  to  determine  a  functional  value  through  linear  interpolation. 

Subroutine  LINMATJ 

This  subroutine  is  to  record  material  types  along  the  1-D  vertical  lines  that  are  associated 
with  1-D  river/stream  nodes. 

Subroutine  LINMAT_2 

This  subroutine  is  to  record  material  types  along  the  1-D  vertical  lines  that  are  associated 
with  2-D  overland  nodes. 

Subroutine  LLTINV 

This  subroutine  is  to  solve  for  a  modified  residual  that  is  to  be  used  in  the  preconditioned 
conjugate  gradient  algorithm. 

Subroutine  LNDGEN_2 
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This  subroutine  is  to  determine  node-node  and  node-element  connectivity  in  2-D  simulations, 
based  on  the  given  element  indices. 

Subroutine  LOCQ_l 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  1-D 
subelement  of  particle  tracking. 

Subroutine  LOCQ_2 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  2-D 
subelement  of  particle  tracking.  The  available  tracking  time  left  after  this  tracking  path  is  also 
computed. 

Subroutine  LOCQ2M 

This  subroutine  is  to  locate  the  target  point  and  its  velocity  for  a  tracking  path  in  a  2-D 
subelement  of  particle  tracking.  The  available  tracking  time  left  after  this  tracking  path  is  also 
computed.  It  is  used  only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow 
equation. 

Subroutine  MMLOC_2 

This  subroutine  is  to  specify  the  starting  location  to  start  the  2-D  “in-element”  particle 
tracking  in  an  element.  The  available  tracking  time  left  after  this  tracking  path  is  also  computed. 

Subroutine  NODV_l 

This  subroutine  is  to  calculate  Manning’s  n  at  every  1-D  global  node. 

Subroutine  NODV_2 

This  subroutine  is  to  calculate  Manning’s  n  at  every  2-D  global  node. 

Subroutine  NUDZ0_1 

This  subroutine  is  to  compute  the  source  term,  which  is  coming  from  non-uniform  bed  slopes 
(in  the  case  of  kinematic  model)  or  potential  slope  (in  the  case  of  diffusive  model),  for  all  global 
nodes  in  1-D  river/stream  flow  simulations. 

Subroutine  NUDZ0_2 

This  subroutine  is  to  compute  the  source  term,  which  is  coming  from  non-uniform  bed  slopes 
(in  the  case  of  kinematic  model)  or  potential  slope  (in  the  case  of  diffusive  model),  for  all  global 
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nodes  in  2-D  overland  flow  simulations. 


Subroutine  OBCOEF2M 

This  subroutine  is  to  determine  the  coefficient  of  a  characteristic  at  an  open  boundary  node. 
The  characteristic  has  been  determined  coming  from  the  outside  of  the  domain. 

Subroutine  ONLINE_2 

This  subroutine  is  to  adjust  the  coordinates  of  a  specified  point  if  needed,  such  that  this  point 
will  be  located  on  the  line  segment  with  two  given  nodes  serving  as  its  end  nodes. 

Subroutine  PAGEN_1 

This  subroutine  is  to  generate  1-D  pointer  arrays  needed  for  numerical  simulations. 

Subroutine  PAGEN_2 

This  subroutine  is  to  generate  2-D  pointer  arrays  needed  for  numerical  simulations. 

Subroutine  PFFCTl 

This  subroutine  is  to  determine  the  functional  value  by  interpolation  from  a  given  profile. 

Subroutine  PFFCT2 

This  subroutine  is  to  determine  the  functional  values  of  an  array  by  interpolation  from  a  series 
of  given  profiles. 

Subroutine  PISS 

This  subroutine  is  to  solver  the  linearized  matrix  equation  with  a  pointwise  iteration  solution 
strategy. 

Subroutine  POLYP 

This  subroutine  is  to  solve  a  modified  residual  that  is  to  be  used  in  the  preconditioned 
conjugate  gradient  algorithm. 

Subroutine  PPCG 

This  subroutine  is  to  solve  the  linearized  matrix  equation  with  the  preconditioned  conjugate 
gradient  method  by  using  a  polynomial  as  a  preconditioner. 
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Subroutine  PREPAR2M 


This  subroutine  is  to  prepare  for  data  needed  to  construct  and  solve  the  set  of  algebraic 
equations  in  Subroutine  ASOLV2M. 

Subroutine  PRINGWl 

This  subroutine  is  to  write  out  simulation  results  of  the  1-D  vertical  subsurface  flow 
simulations  that  are  corresponding  to  river/stream  nodes. 

Subroutine  PRINGW2 

This  subroutine  is  to  write  out  simulation  results  of  the  1-D  vertical  subsurface  flow 
simulations  that  are  corresponding  to  overland  nodes. 

Subroutine  PRINTT_1 

This  subroutine  is  to  write  out  simulation  results  of  1-D  river/stream  simulations. 

Subroutine  PRINTT_2 

This  subroutine  is  to  write  out  simulation  results  of  2-D  overland  simulations. 

Subroutine  Q2 

This  subroutine  is  to  estimate  the  integration  over  a  line  element. 

Subroutine  Q2D 

This  subroutine  is  to  estimate  the  integration  over  a  line  element. 

Subroutine  Q2FHJX 

This  subroutine  is  to  perform  boundary  integration  over  a  2-D  boundary  side. 

Subroutine  Q2F1 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vector  to  compute  the 
gradients  of  bottom  elevation,  water  stage,  velocities,  and  Manning’s  n  in  1-D  river/stream  flow 
simulations. 

Subroutine  Q2F2 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vector  to  compute  the 
gradients  of  the  derivatives  of  bottom  elevation  in  1-D  river/stream  flow  simulations. 
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Subroutine  Q2F3 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vector  to  compute  the 
gradients  of  hydraulic  radius  and  average  river/stream  width  in  1-D  river/stream  flow  simulations. 

Subroutine  Q2T 

This  subroutine  is  to  determine  the  line  element  coefficient  matrices  and  load  vector  to  sole 
1-D  transport  equation  in  the  Eulerian  step. 

Subroutine  Q3T 

This  subroutine  is  to  determine  the  triangular  element  coefficient  matrices  and  load  vector 
to  sole  2-D  transport  equation  in  the  Eulerian  step. 

Subroutine  Q4T 

This  subroutine  is  to  determine  the  quadrilateral  element  coefficient  matrices  and  load  vector 
to  sole  2-D  transport  equation  in  the  Eulerian  step. 

Subroutine  Q34FM 

This  subroutine  is  to  determine  the  element  coefficient  matrices,  including  mass  matrices  and 
the  stiffiiess  matrices  taking  into  account  eddy  viscosity  in  soling  2-D  dynamic  wave  model. 

Subroutine  Q34F1 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vector  to  compute  the 
gradients  of  bottom  elevation,  water  stage,  velocities,  and  Manning’s  n  in  2-D  overland  flow 
simulations. 

Subroutine  Q34F2 

This  subroutine  is  to  determine  element  coefficient  matrices  and  load  vector  to  compute  the 
gradients  of  the  derivatives  of  bottom  elevation  in  2-D  overland  flow  simulations. 

Subroutine  RAINOD_l 

This  subroutine  is  to  determine  rainfall  rate  at  1-D  global  nodes. 

Subroutine  RAINOD_2 

This  subroutine  is  to  determine  rainfall  rate  at  2-D  global  nodes. 
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Subroutine  REPLAS  2 


This  subroutine  is  to  write  the  values  of  the  first  four  arguments  into  the  last  four  arguments. 

Subroutine  RESIDU_1 

This  subroutine  is  compute  the  residual  of  the  1-D  transport  equations  of  (1)  dissolved 
chemicals  (ED  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (ID  =  1),  (3)  particulate 
chemicals  on  bed  sediments  (ID  =1),  and  (4)  suspended  sediments  (ID  =  2)  at  the  NP-th  node  (when 
NP  is  not  equal  to  zero  and  J  equals  zero)  or  the  J-th  junction  (when  NP  equals  zero  and  J  is  not 
equal  to  zero).  The  residuals  are  defined  as  follows. 

For  the  case  at  the  NP-th  node: 


(1)  For  dissolved  chemicals: 

RESq  =  A[(CiT"'  -(CiT"‘'^]  -  St  (RHSCi)^"*  +  6t  (RHSCj)^  ie[l,NJ 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RESq  =  A[(S„q)^"‘-(S„q)N*i"]-6t(RHSq)N*i  +  6t(RHSq)N 

ne[l,q],  ie[l,NJ,  k=n*N^+i 

(3)  For  particulate  chemicals  on  bed  sediments: 


(n.40) 


(n.4i) 


RESq  =  (M„qy^'-(M„C^)''-At(RHSq)N^' 
neEfNJ,  ie[l,NJ,  k  =  (n+N3)*N^  +  i 


(n.42) 


(4)  For  suspended  sediments: 

RESS„  =  +  ne[l,q]  (0.43) 

where  (RHSSn)^*^  is  evaluated  with  ID  =  22  in  subroutine  RHSCOMPl,  whereas  (RH(^S  )  is 
calculated  with  ID  =  21. 


For  the  case  at  the  J-th  junction: 
(1)  For  dissolved  chemicals: 


RESq  =  [(V(J)q"'(J))N"^-(V(J)q'"(J))N]-At(RHSq)N"^  ie[l,NJ 
(2)  For  particulate  chemicals  on  suspended  sediments: 


REsq  =  [(v(j)s„(j)q(j))N^*-(v(j)s„(j)q(j))N]-At(RHsq)''^ 


ne[l,q],  ie[l,NJ,  k=n*N,+i 


(0.44) 


(0.45) 
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(3)  For  particulate  chemicals  on  bed  sediments: 

RESq  =  (M„(J)C„"(J)f^‘-(M„(J)C„W-At(RHSq)N^i 
ne[l,NJ,  ie[l,NJ,  k=(n+N,)*N^+i 

(4)  For  suspended  sediments: 

RESS„  =  (V(J)S„(J)f  +  AtCRKSS^)*^**  ne[l,NJ 

Subroutine  RESIDU_2 


(n.46) 


(n.47) 


This  subroutine  is  compute  the  residual  of  the  2-D  transport  equations  of  (1)  dissolved 
chemicals  (ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (ID  =  1),  (3)  particulate 
chemicals  on  bed  sediments  (ID  =  1),  and  (4)  suspended  sediments  ( ID  =  2)  at  the  NP-th  node.  The 
residuals  are  defined  as  follows 


For  the  case  at  the  NP-th  node: 


(1)  For  dissolved  chemicals: 

RESCj  =  h[(CiT"‘  -(CiT"‘"]  -  6t(RHSCi)N"i  +  6t(RHSCi)N  ie[l,NJ 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RESq  =  h[(S„ON*‘  -(S„C^f  6t(RHSq)^"‘  +  6t  (RHSq)^ 

ne[l,NJ,  i6[l,NJ,  k=n=.=N^+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

REsq  =  (M„qy^i-(M„C„y-At(RHSq)N^i 

n6[l,Nl,  i6[l,Nl,  k  =  (n+N)*N  +i 


(0.48) 


(0.49) 


(0.50) 


(4)  For  suspended  sediments: 

RESS„  =  h(SJ^"‘"  +  6t(RHSS„)N"‘-6t(RHSS„)^  ne[l,NJ  (0.51) 

where  (RHSS„)^*‘  is  evaluated  with  ID  =  22  in  subroutine  RHSCOMPl,  whereas  (RI^S  )  is 
calculated  with  ID  =  21. 


Subroutine  RHSCMP_1 


This  subroutine  is  to  compute  the  right-hand  side  of  the  1-D  transport  governing  equations 
of  (1)  dissolved  chemicals  (ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (ID  =  1),  (3) 
particulate  chemicals  on  bed  sediments  (ID  =1),  and  (4)  suspended  sediments  (ID  =  21  or  22)  at  the 
NP-th  node  (when  NP  is  not  equal  to  zero  and  J  equals  zero)  or  the  J-th  junction  (when  NP  equals 
zero  and  J  is  not  equal  to  zero).  The  right-hand  sides  are  defined  as  follows. 
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(1)  For  dissolved  chemicals: 
RHSC,  = 


M".Afc,''-p,+:El4'’S.AC>£CM.PC„‘+E  CaH 

n=l  n=l  m=l  j=l 


(n.52) 


ArA+Aki^+X:  (q^^^+R-I+Rj-pR^  q'’ 


ie[l,NJ 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RHSq  =  [M“+k^'s„Aq"-pBR„C„'-BD„C>Mr] 

-[A^+k^J’A+R-I+Ri+R^Js^C^  n6[l,NJ,  ie[l,NJ,  k=n*N,+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

RHSC,  =  [D„C^-R„C^k„XCi1-[^^+CKc^" 
n6[l,NJ,i6[l,NJ,  k  =  (n+N3)*N^+i 


(n.53) 


(n.54) 
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(4)  For  suspended  sediments: 

(a)  when  ID  =  21, 

RHSS„  =  [m>PR„-PD„+M“]-[R-I+R,+R2]S„  ne[l,NJ 

(b)  when  ID  =  22, 

RHSS„  =  [m;  +PR„  -PD„  +M  “]  ne[l,NJ 
For  the  case  at  the  J-th  junction: 


(n.55) 


(n.56) 


(1)  For  dissolved  chemicals: 
RHSC  = 


NJRTHd) 


52  Q -X*V(J)Ci"'(J) +Mi“*(J)  +V(J)k“  p; -^C *(J) 


ab  K 


N,  [  jsf  N,  jbf 

^Ek*S„(J)V(J)  C^(J)-±5iC*(J)  +5:k^'’M„(J)AJT(J)  C„'(J) --^C  *(J) 

14”  n=i  k”” 


(n.57) 


+  E  l^Vd)  n  (Cj"(J))'’“*  ~U  (Cj*(J))““^  i6[l,NJ 

m=l  j=l  j=l 

(2)  For  particulate  chemicals  on  suspended  sediments: 

NJRTHO) 

RHSq  =  E  Q'^S„C^'‘+M^V)-A^V(J)S„(J)C^(J)-14”s„(J)V(J)  C^(J)-^C*(J) 
>^=1  kni 


(n.58) 


+R„(J)AJT(J)0)-D„(J)AJT(J)C^(J)+Mra)  ne[l,NJ,  i6[l,NJ,  k=n*N^+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

[  k**^ 

RHSq  =  [D„(J)C^(J)-R„(J)C„”(J))-A.”(J)M„(J)C„”(J)-k„””M^^^^  C„”(J)-^C  *(J) 

k^  J  (n.59) 

n6[l,NJ,ie[l,NJ,  k=(n+N3)=^N^+i 

(4)  For  suspended  sediments: 

NJRTHO) 

RHSS„  =  E  Q'‘S„"+M;(J)+M“(J)  +  [R„(J)-D„(J)]AJT(J)  n6[l,N3]  (n.60) 


Subroutine  RHSCMP  2 


This  subroutine  is  to  compute  the  right-hand  side  of  the  2-D  transport  governing  equations 
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of  (1)  dissolved  chemicals  (ID  =  1),  (2)  particulate  chemicals  on  suspended  sediments  (ID  =  1),  (3) 
particulate  chemicals  on  bed  sediments  (ID  =1),  and  (4)  suspended  sediments  (ID  =  21  or  22)  at  the 
NP-th  node.  The  right-hand  sides  are  defined  as  follows. 

(1)  For  dissolved  chemicals: 

RHSC.  =  +E  l4"s„hC^  +E  +  E 

n=l  n=l  m=l  j=l 


(n.6i) 


-  Afh+hki’^+E  S„hl4^E  M„k^'+E  n  (CjT”^+R-I  C*  i6[l,NJ 

n=I  n=l  m=l 

(2)  For  particulate  chemicals  on  suspended  sediments: 

RHSC,  =  [M“+k^'hS„q"-HR„C^D„C^]-kh+k^h+R-l]s„C^ 

J  L  i  ( 

ne[l,NJ,  i6[l,NJ,  k=n*N^+i 

(3)  For  particulate  chemicals  on  bed  sediments: 

RHsq  -  [D.c^R.c„‘H-k“M.c"]-[x‘ 


(n.62) 


n6[l,Nl,ie[l,NJ,  k  =  (n+N)*N  +i 


(n.63) 


(4)  For  suspended  sediments: 
(a)  when  ID  =  21, 


RHSS„  =  [m;-^R„-dJ-[R-I]S„  ne[l,NJ 


(b)  when  ID  =  22, 


RHSS 


„  =[m>R„-dJ  ne[l,NJ 


(n.64) 


(n.65) 


Subroutine  RINGS 


This  subroutine  is  to  read  in  chemistry  and  sediment  information. 


Subroutine  RINF  1 


This  subroutine  is  to  read  in  information  for  1-D  river/stream  flow  simulations. 

Subroutine  RINF_2 

This  subroutine  is  to  read  in  information  for  2-D  overland  flow  simulations. 

Subroutine  RINTTll 


This  subroutine  is  to  read  in  the  initial  condition  for  the  1-D  vertical  subsurface  flow 
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simulations  that  are  corresponding  to  river/stream  nodes. 

Subroutine  RINIT12 

This  subroutine  is  to  read  in  the  initial  condition  for  the  1-D  vertical  subsurface  flow 
simulations  that  are  corresponding  to  overland  nodes. 

Subroutine  RINIT_1 

This  subroutine  is  to  read  in  the  initial  condition  for  1-D  river/stream  flow  and/or  transport 
simulations. 

Subroutine  RINIT_2 

This  subroutine  is  to  read  in  the  initial  condition  for  2-D  overland  flow  and/or  transport 
simulations. 

Subroutine  RINPUTll 

This  subroutine  is  to  read  in  information  for  the  1-D  vertical  subsurface  flow  simulations  that 
are  corresponding  to  river/stream  nodes. 

Subroutine  RINPUT12 

This  subroutine  is  to  read  in  information  for  the  1-D  vertical  subsurface  flow  simulations  that 
are  corresponding  to  overland  nodes. 

Subroutine  RINT_1 

This  subroutine  is  to  read  in  information  for  1-D  river/stream  transport. 

Subroutine  RINT_2 

This  subroutine  is  to  read  in  information  for  2-D  overland  transport. 

Subroutine  SOL_BS 

This  subroutine  is  to  solve  the  transport  governing  equation  of  bed  sediments  at  the  NP-th 
river/stream  or  overland  node. 

Subroutine  SOL_BSJT 

This  subroutine  is  to  solve  the  transport  governing  equation  of  bed  sediments  at  the  DT-th 
junction.. 
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Subroutine  SOL  Cl 


This  subroutine  is  to  solve  for  the  concentrations  of  dissolved  chemicals,  particulate 
chemicals  on  suspended  sediments,  and  particulate  sediments  on  bed  sediments  at  1-D  global  nodes 
(ID  =  1)  or  at  jimctions  (ID  =  2).  For  the  case  at  global  nodes,  this  subroutine  serves  as  the  corrector 
step  in  our  predictor-coirector  approach  to  solve  transport  equations  of  chemicals.  For  the  case  at 
jimctions,  the  governing  equations  accounting  for  chemical  interactions  are  solved  in  this  subroutine. 
The  Newton-Raphson  method  is  employed  to  solve  the  nonlinear  system  of  chemical  reactions.  The 
ftiU-pivoting  technique  is  incorporated  into  a  direct  solver  to  handle  linearized  matrix  equations. 

Subroutine  SOL_C2 

This  subroutine  is  to  solve  for  the  concentrations  of  dissolved  chemicals,  particulate 
chemicals  on  suspended  sediments,  and  particulate  sediments  on  bed  sediments  at  2-D  global  nodes. 
This  subroutine  serves  as  the  corrector  step  in  our  predictor-corrector  approach  to  solve  transport 
equations  of  chemicals.  The  Newton-Raphson  method  is  employed  to  solve  the  nonlinear  system 
of  chemical  reactions.  The  fiill-pivoting  technique  is  incorporated  into  a  direct  solver  to  handle 
linearized  matrix  equations. 

Subroutine  SOL_SSl 

This  subroutine  is  to  solve  the  transport  governing  equation  of  suspended  sediments  at  the 
NP-th  river/stream  node,  where  the  time-implicit  scheme  is  employed. 

Subroutine  SOL_SS2 

This  subroutine  is  to  solve  the  transport  governing  equation  of  suspended  sediments  at  the 
NP-th  overland  node,  where  the  time-implicit  scheme  is  employed. 

Subroutine  SOL_SSJT 

This  subroutine  is  to  solve  the  transport  governing  equation  of  suspended  sediments  at  the 
UT-th  junction,  where  the  time-implicit  scheme  is  employed. 

Subroutine  SPROP_l 

This  subroutine  is  to  compute  hydraulic  conductivity  and  water  capacity  in  the  river/stream 
node-associated  1-D  vertical  subsurface  simulations. 

Subroutine  SPROP_2 

This  subroutine  is  to  compute  hydraulic  conductivity  and  water  capacity  in  the  overland 
node-associated  1-D  vertical  subsurface  simulations. 
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Subroutine  STAR2M 


This  subroutine  is  to  determine  the  Lagrangian  values  (i.e.,  Hj*,  Uj*,  Vj*,  H2*,  Uj*,  V2*,  H3*,  U3*, 
V3*  appeared  in  Section  3.2.1)  associated  with  each  characteristic. 

Subroutine  STORE_l 

This  subroutine  is  to  store  the  computer  results  of  1-D  river/stream,  in  relation  to  the  post¬ 
processor  of  Watershed  Modeling  System  (WMS). 

Subroutine  STORE_2 

This  subroutine  is  to  store  the  computer  results  of  2-D  overland,  in  relation  to  the  post¬ 
processor  of  Watershed  Modeling  System  (WMS). 

Subroutine  STORE_lD 

This  subroutine  is  to  store  the  computer  results  of  1-D  river/stream  in  a  binary  file  for  further 
plotting  purposes. 

Subroutine  STORE_2D 

This  subroutine  is  to  store  the  computer  results  of  2-D  overland  in  a  binary  file  for  further 
plotting  purposes. 

Subroutine  STRIP 

This  subroutine  is  to  read  in  a  character  variable. 

Subroutine  SURE_2 

This  subroutine  is  to  analytically  determine  the  target  location  of  a  2-D  tracking  path  when 
the  single- velocity  approach  is  applied. 

Subroutine  SURE2M 

This  subroutine  is  to  analytically  determine  the  target  location  of  a  2-D  tracking  path  when 
the  single-velocity  approach  is  applied.  It  is  used  only  when  the  method  of  characteristics  is 
employed  to  solve  the  2-D  flow  equation. 

Subroutine  SURF_2 

This  subroutine  is  to  generate  boundary  arrays  for  implementing  boundary  conditions  in  2-D 
simulations. 
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Subroutine  TRAK  VI 


This  subroutine  is  to  determine  the  tracking  velocity  for  implementation  of  the  Lagrangian 
step  of  1-D  river/stream  flow  computation 

Subroutine  TRAK_1 

This  subroutine  is  to  determine  the  target  location  of  a  tracking  path  in  a  1-D  subelement. 

Subroutine  TRAK_21 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass 
through  the  working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where 
an  subelement  node  is  located. 

Subroutine  TRAK_22 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass 
through  the  working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not 
where  an  subelement  node  is  located. 

Subroutine  TRAK21M 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass 
through  the  working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  where 
an  subelement  node  is  located.  It  is  used  only  when  the  method  of  characteristics  is  employed  to 
solve  the  2-D  flow  equation. 

Subroutine  TRAK22M 

This  subroutine  is  to  determine  (1)  whether  or  not  a  particle  will  pass  through  the  working 
subelement  being  considered  and  (2)  the  location  of  the  target  location  if  the  particle  will  pass 
through  the  working  subelement.  This  subroutine  is  employed  when  the  starting  location  is  not 
where  an  subelement  node  is  located.  It  is  used  only  when  the  method  of  characteristics  is  employed 
to  solve  the  2-D  flow  equation. 

Subroutine  TRANSP_1 

This  subroutine  serves  as  the  control  panel  to  compute  both  contaminant  and  sediment 
transport  of  1-D  river/stream.  The  predictor-corrector  numerical  approach  is  employed  to  solve  the 
transport  equations  of  mobile  materials,  such  as  dissolved  chemicals,  suspended  sediments,  and 


Appendix  B-42 


particulate  chemicals  on  suspended  sediments.  During  each  time  step,  The  predictor  step  is  first 
implemented  to  obtain  the  intermediate  values  for  mobile  materials.  Sediment  equations  are  then 
solved  by  using  the  Picard  to  handle  their  nonlinearity.  The  concentrations  of  contaminants  are  the 
last  to  solve  for.  The  set  of  nonlinear  algebraic  equations  is  solved  with  the  Newton-Raphson 
method  node  by  node  in  the  corrector  step. 

Subroutine  TRANSP_2 

This  subroutine  serves  as  the  control  panel  to  compute  both  contaminant  and  sediment 
transport  of  2-D  overland.  The  predictor-corrector  numerical  approach  is  employed  to  solve  the 
transport  equations  of  mobile  materials,  such  as  dissolved  chemicals,  suspended  sediments,  and 
particulate  chemicals  on  suspended  sediments.  During  each  time  step.  The  predictor  step  is  first 
implemented  to  obtain  the  intermediate  values  for  mobile  materials.  Sediment  equations  are  then 
solved  by  using  the  Picard  to  handle  their  nonlinearity.  The  concentrations  of  contaminants  are  the 
last  to  solve  for.  The  set  of  nonlinear  algebraic  equations  is  solved  with  the  Newton-Raphson 
method  node  by  node  in  the  corrector  step. 

Subroutine  TRILRN2M 

This  subroutine  is  to  generate  pointer  arrays  for  the  use  in  constructing  the  matrix  equation 
for  adjusting  2-D  flow  velocity  in  the  last  part  of  the  method  of  characteristic  approach. 

Subroutine  TSCONV 

This  subroutine  is  to  retrieve  desired  profiles  from  given  x-y  series  curves. 

Subroutine  TSCONW 

This  subroutine  is  to  retrieve  desired  profiles  from  given  x-y  series  curves. 

Subroutine  TSCONV2 

This  subroutine  is  to  retrieve  desired  profiles  from  given  x-y  series  curves. 

Subroutine  VALBDL_2 

This  subroutine  is  to  compute  the  velocity  at  a  specified  2-D  node  by  interpolation. 

Subroutine  yALBDL2M 

This  subroutine  is  to  compute  the  velocity  at  a  specified  2-D  node  by  interpolation.  It  is  used 
only  when  the  method  of  characteristics  is  employed  to  solve  the  2-D  flow  equation. 

Subroutine  VELTGWl 
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This  subroutine  is  to  calculate  the  velocity  at  all  nodes  in  the  river/stream  node-associated 

1- D  vertical  subsurface  simulations. 

Subroutine  VELTGW2 

This  subroutine  is  to  calculate  the  velocity  at  all  nodes  in  the  overland  node-associated  1-D 
vertical  subsurface  simulations. 

Subroutine  VELT_1 

This  subroutine  is  to  compute  the  kinematic  or  diffusion  velocities  at  all  river/stream  nodes. 

Subroutine  VELT_2 

This  subroutine  is  to  compute  the  kinematic  or  diffusion  velocities  at  all  overland  nodes. 

Subroutine  WRKARY_2 

This  subroutine  is  to  prepare  working  arrays  for  particle  tracking  in  either  a  2-D  element  or 
a  2-D  subelement. 

Subroutine  WRKARY2M 

This  subroutine  is  to  prepare  working  arrays  for  particle  tracking  in  either  a  2-D  element  or 
a  2-D  subelement.  It  is  employed  only  when  the  method  of  characteristics  is  employed  to  solve  the 

2- D  flow  equation. 

Subroutine  XSI_2 

This  subroutine  is  to  detennine  the  local  coordinates  of  a  specified  node  that  is  located  in  a 
2-D  element,  given  the  original  Cartesian  coordinates  of  both  the  node  and  element  nodes. 
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APPENDIX  C  PARAMETERS  FOR  RUNNING  THE  COMPUTER  CODE 


The  following  is  the  content  of  the  including  file,  wmparal2.mc,  which  is  required  to  compile  and 
run  the  computer  code  of  the  model.  One  needs  to  modify  wmparal2.inc  in  order  to  provide  appropriate 
values  for  the  code  parameters  as  defined  as  follows. 

C 

C CONTROL  INTEGERS  FOR  THE  SPATIAL  DOMAIN  OF  2-D  OVERLAND  FLOW 

C 

C  MAXNPK2  :  MAX.  NO.  OF  NODES 
C  MAXELK2  :  MAX.  NO.  OF  ELEMENTS 
C  MXBNPK2  :  MAX.  NO.  OF  BOUNDARY  NODAL  POINTS 
C  MXBESK2  :  MAX.  NO.  OF  BOUNDARY-ELEMENT  SURFACES 

C  MXJBDK2  :  MAX.  NO.  OF  NONZERO  ELEMENTS  IN  ANY  ROW  FOR  NODE-WISE 
CONNECTIVITY 

C  MXKBDK2  :  MAX.  NO.  OF  NONZERO  ELEMENTS  IN  ANY  ROW  FOR  ELEMENT-WISE 

CONNECTIVITY 

C 

PARAMETER  (MAXNPK2=275,MAXELK2=462,MXBNPK2=1000,MXBESK2=1000) 
PARAMETER  (MXJBDK2=20,MXKBDK2=20) 

- CONTROL  INTEGERS  FOR  THE  TIME  DOMAIN  OF  2-D  OVERLAND  FLOW 

MXNTIK2  :  MAX.  NO.  OF  TIME  STEPS 

MXDTCK2  :  MAX.  NO.  OF  CHANGES  OF  THE  2-D  TIME  STEP  SIZE. 

PARAMETER  (MXNTIK2=50000,MXDTCK2=20) 

- CONTROL  INTEGERS  FOR  MATERIAL  PROPERTIES  OF  2-D  OVERLAND  FLOW 

MXMATK2  ;  MAX.  NO.  OF  MATERIAL  TYPES 

MXMPMK2  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL 

PARAMETER  (MXMATK2=10,MXMPMK2=6) 

- CONTROL  INTEGERS  FOR  RAINFALL  OF  2-D  OVERLAND  FLOW 

MXRESK2  :  MAX.  NO.  OF  ELEMENTS  WITH  RAINFALL  CONDITION 
MXRPRK2  :  MAX.  NO.  OF  RAINFALL  PROFILES 
MXRDPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  RAINFALL  PROFILE 

PARAMETER  (MXRESK2=MAXELK2,MXRPRK2=5,MXRDPK2=200) 

- CONTROL  INTEGERS  FOR  SOURCE/SINK  OF  2-D  OVERLAND  FLOW 

MXSPRK2  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 
MXSDPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  SOURCE/SINK  PROFILE 

PARAMETER  (MXSPRK2=5,MXSDPK2=200) 
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c 

C CONTROL  INTEGERS  FOR  OPEN  BOUNDARY  CONDITIONS  OF  2-D  OVERLAND  FLOW 

C 

C  MXDNPK2  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  NODAL  POINTS 
C  MXDPRK2  ;  MAX.  NO.  OF  DIRICHLET  BOUNDARY  PROFILES 
C  MXDDPK2  :  MAX.  NO.  OF  DATA  POINTS  IN  A  DIRICHLET  PROFILES 
C  MXCESK2  :  MAX.  NO.  OF  FLUX-TYPE  BOUNDARY  SIDES. 

C  MXFPRK2  :  MAX.  NO.  OF  UPSTREAM  BOUNDARY  FLUX  PROFILES 
C  MXFDPK2  :  MAX.  NO.  OF  DATA  POINTS  IN  A  UPSTREAM  BOUNDARY  PROFILE 
C  MXCPRK2  :  MAX.  NO.  OF  DEPTH- OR  STAGE-DEPENDENT  FLUX  PROFILES 
C  MXCDPK2  :  MAX.  NO.  OF  DATA  POINTS  IN  A  DEPTH-  OR  STAGE-DEPENDENT  FLUX 
PROFILE 
C 

PARAMETER  (MXDNPK2=500,MXDPRK2=10,MXDDPK2=500) 

PARAMETER  (MXCESK2=500,MXFPRK2=10,MXFDPK2=300) 

PARAMETER  (MXCPRK2=3,MXCDPK2=300) 

- CONTROL  INTEGERS  FOR  CLOSED  BOUNDARY  CONDITIONS  OF  2-D  OVERLAND  FLOW 

MXIBPK2  :  MAX.  NO.  OF  CLOSED  BOUNDARY  NODAL  POINTS 
PARAMETER  (MXIBPK2=500) 

- CONTROL  INTEGERS  FOR  SUB-ELEMENT  TRACKING  OF  2-D  OVERLAND  FLOW 

MXNPWK2  :  MAX.  NO.  OF  NODES  FOR  A  SUB-ELEMENT  TRACKING 
MXELWK2  :  MAX.  NO.  OF  SUB-ELEMENTS  FOR  A  SUB-ELEMENT  TRACKING 

PARAMETER  (MXNPWK2=121,MXELWK2=100) 

C 

C CONTROL  INTEGERS  FOR  THE  SPATIAL  DOMAIN  OF  1-D  SUBSURFACE  FLOW 

C  CORRESPONDING  TO  2-D  OVERLAND  NODES 

C 

C  MXELGK2  :  MAX.  NO.  OF  SUBSURFACE  ELEMENTS  JN  EACH  VERTICAL  COLUMN 
C  MXNPGK2  :  MAX.  NO.  OF  NODAL  POINTS  IN  EACH  VERTICAL  COLUMN 
C 

PARAMETER  (MXELGK2=40,MXNPGK2=MXELGK2+1) 

C 

C CONTROL  INTEGERS  FOR  MATERIAL  AND  SOIL  PROPERTIES  OF  SUBSURFACE  FLOW 

C  CORRESPONDING  TO  2-D  OVERLAND  NODES 
C 

C  MXMTGK2  :  MAX.  NO.  OF  SOIL  MATERIAL  TYPES 

C  MXSPGK2  :  MAX.  NO.  OF  SOIL  PARAMETERS  TO  DESCRIBE  WATER  RETENTION  CURVES 
C  MXMPGK2  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL 
C  MXN01K2  :  MAX.  NO.  OF  ELEMENTS  WITH  MATERIAL  TYPE  OTHER  THAN  1 
C 

PARAMETER  (MXMTGK2=10,MXSPGK2=25,MXMPGK2=6,MXN01K2=100) 

C 
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C  -  CONTROL  INTEGERS  FOR  BOUNDARY  CONDITIONS  OF  SUBSURFACE  FLOW 

CORRESPONDING 

C  TO  2-D  OVERLAND  NODES 

C 

C  MXPRFK2  :  MAX.  NO.  OF  BOUNDARY  PROFILES 
C  MXBDPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  PROFILE 
C 

PARAMETER  (MXPRFK2=2,MXBDPK2=4) 

C 

C CONTROL  INTEGERS  FOR  HYDROGRAPH  OF  2-D  OVERLAND  FLOW 

C 

C  MXPNTK2  :  MAX.  NO.  OF  NODAL  POINTS  FOR  THE  LINE  CROSS  SECTION 
C  MXLINK2  :  MAX.  NO.  OF  LINE  CROSS  SECTION  CAN  BE  SELECTED 
C  MXITPK2  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  HYDROGRAPH 
C 

PARAMETER  (MXPNTK2=50,MXLINK2=10,MXITPK2=100) 

C 

C - CONTROL  INTEGERS  FOR  2-D  OVERLAND  TRANSPORT 

C 

C  MXMMMK2  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL  FOR  TRANSPORT 
C  MXSRPRK2  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 

C  MXSRDPK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  SOURCE/SINK  PROFILE 
C  MXCESTK2  :  MAX.  NO.  OF  FLUX-TYPE  BOUNDARY  SIDES  OF  TRANSPORT 
C  MXCPRTK2  :  MAX.  NO.  OF  FLUX-TYPE  BOUNDARY  CONDITION  PROFILES  OF  TRANSPORT 
C  MXCDPTK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  FLUX-TYPE  BOUNDARY 
C  CONDITION  PROFILE  OF  TRANSPORT 

C  MXDNPTK2  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  NODES  OF  TRANSPORT 
C  MXDPRTK2  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  CONDinON  PROFILES  OF  TRANSPORT 
C  MXDDPTK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  DIRICHLET  BOUNDARY 
C  CONDITION  PROFILE  OF  TRANSPORT 

C  MXRCPRK2  :  MAX.  NO.  OF  CHEMICAL  CONCENTRATION  PROFILES  IN  RAINFALL 
C  MXRCDPK2  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  CHEMICAL 
CONCENTRATION 
C  PROFILES  IN  RAINFALL 

C 

PARAMETER  (MXMMMK2=3) 

PARAMETER  (MXSRPRK2=20,MXSRDPK2=20) 

PARAMETER  (MXRCPRK2=20,MXRCDPK2=20) 

PARAMETER  (MXDNPTK2=200,MXDPRTK2=200,MXDDPTK2=100) 

PARAMETER  (MXCESTK2=200,MXCPRTK2=200,MXCDPTK2=100) 

C 

c CONTROL  INTEGERS  FOR  THE  SPATIAL  DOMAIN  OF  1-D  RIVER/STREAM  FLOW 

C 

C  MAXNPKl  :  MAX.  NO.  OF  NODES 
C  MAXELKl  :  MAX.  NO.  OF  ELEMENTS 
C 

PARAMETER  (MAXNPK1=500,MAXELK1=500) 

C 
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- CONTROL  INTEGERS  FOR  THE  TIME  DOMAIN  OF  1-D  RIVER/STREAM  FLOW 

MXNTKl  ;  MAX.  NO.  OF  TIME  STEPS 

MXDTCKl  :  MAX.  NO.  OF  CHANGES  OF  THE  1-D  TIME  STEP  SIZE 
PARAMETER  (MXNTIK1=5000,MXDTCK1=20) 

- CONTROL  INTEGERS  FOR  MATERIAL  PROPERTIES  OF  1-D  RIVER/STREAM  FLOW 

MXMATK  .  MAX.  NO.  OF  MATERIAL  TYPES 

MXMPMK  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL 

PARAMETER  (MXMATK1=10,MXMPMK1=6) 

- CONTROL  INTEGERS  FOR  RAINFALL  OF  1-D  RIVER/STREAM  FLOW 

MXRESKl  :  MAX.  NO.  OF  ELEMENTS  WITH  RAINFALL  CONDIHON 
MXRPRKl  :  MAX.  NO.  OF  RAINFALL  PROFILES 
MXRDPKl  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  RAINFALL  PROFILE 

PARAMETER  (MXRESK1=MAXELK1,MXRPRK1=5,MXRDPK1=200) 

- CONTROL  ROGERS  FOR  SOURCE/SINK  OF  1-D  RIVER/STREAM  FLOW 

MXSPRKl  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 
MXSDPKl  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  SOURCE/SINK  PROFILE 
MXSJPRKl  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES  AT  JUNCTIONS 
MXSJDPKl  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  SOURCE/SINK  PROFILE  AT  JUNCTIONS 

PARAMETER  (MXSPRK1=5,MXSDPK1=200) 

PARAMETER  (MXSJPRK1=5,MXSJDPK1=200) 

- CONTROL  INTEGERS  FOR  OPEN  BOUNDARY  CONDITIONS  OF  1-D  RIVER/STREAM  FLOW 

MXDNPKl  :  MAX.  NO.  OF  OPEN  BOUNDARY  NODAL  POINTS 
MXDPRKl  :  MAX.  NO.  OF  OPEN  BOUNDARY  PROFILES 
MXDDPKl  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  PROFILES 

PARAMETER  (MXDNPK1=500,MXDPRK1=50,MXDDPK1=300) 

PARAMETER  (MXCPRK1=10,MXCDPK1=300) 

- CONTROL  INTEGERS  FOR  1-D  RIVER/STREAM  REACH  NUMBER 

MXRHKl  ;  MAX.  NO.  OF  RIVER/STREAM  REACH  NUMBER 
MXRHNPKl :  MAX.  NO.  OF  NODES  INCLUDED  IN  A  RIVER/STREAM  REACH 

PARAMETER  (MXRHK1=10,MXRHNPK1=100) 

C 
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c - CONTROL  INTEGERS  FOR  CROSS-SECTIONAL  GEOMETRY  FOR  1-D  RIVER/STREAM 

FLOW 

MXCNPKl  :  MAX.  NO.  OF  DATA  POINTS  FOR  CROSS-SECTIONAL  GEOMETRY  PROFILES 
PARAMETER  (MXCNPK1=200) 

- CONTROL  INTEGERS  FOR  RIVER/STREAM  JUNCTIONS 

MXJTKl  :  MAX.  NO.  OF  RIVER/STREAM  JUNCTIONS 

MXJTRKl  :  MAX.  NO.  OF  RIVER/STREAM  REACHES  CONNECTED  TO  A  JUNCTION 
MXJTPKl  :  MAX.  NO.  OF  RIVER/STREAM  JUNCTION  PROFILES 
MXJTDKl  ;  MAX.  NO.  OF  DATA  POINTS  ON  THE  PROFILES 
MXNJTSKl ;  MAX.  NO.  OF  JUNCTION-RELATED  OVERLAND  BOUNDARY  SIDES 
TO  A  JUNCTION. 

PARAMETER  (MXJTK1=500,MXJTRK1=50,MXJTPK1=50,MXJTDK1=100) 

PARAMETER  (MXNJTSK1=50) 

- CONTROL  INTEGERS  FOR  SUB-ELEMENT  TRACKING  FOR  1-D  RIVER/STREAM  FLOW 

MXNPWKl  :  MAX.  NO.  OF  NODES  FOR  A  SUB-ELEMENT  TRACKING 
PARAMETER  (MXNPWK1=11) 

- CONTROL  INTEGERS  FOR  THE  SPATIAL  DOMAIN  OF  1-D  SUBSURFACE  FLOW 

CORRESPONDING  TO  1-D  RIVER/STREAM  NODES 

MXELGKl  :  MAX.  NO.  OF  SUBSURFACE  ELEMENTS  IN  EACH  VERTICAL  COLUMN 
MXNPGKl  :  MAX.  NO.  OF  NODAL  POINTS  IN  EACH  VERTICAL  COLUMN 

PARAMETER  (MXELGK1=40,MXNPGK1=MXELGK1+1) 

- CONTROL  INTEGERS  FOR  MATERIAL  AND  SOIL  PROPERTIES  OF  SUBSURFACE  FLOW 

CORRESPONDING  TO  1-D  RIVER/STREAM  NODES 

MXMTGKl  :  MAX.  NO.  OF  SOIL  MATERIAL  TYPES 

MXSPGKl  :  MAX.  NO.  OF  SOIL  PARAMETERS  TO  DESCRIBE  WATER  RETENTION  CURVE 
MXMPGKl  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL 
MXNOIKI  :  MAX.  NO.  OF  ELEMENTS  WITH  MATERIAL  TYPE  OTHER  THAN  1 

PARAMETER  (MXMTGK1=10,MXSPGK1=25,MXMPGK1=6,MXN01K1=100) 

-  CONTROL  INTEGERS  FOR  BOUNDARY  CONDITIONS  OF  SUBSURFACE  FLOW 

CORRESPONDING 

C  TO  1-D  RIVER/STREAM  NODES 

C 

C  MXPRFKl  :  MAX.  NO.  OF  BOUNDARY  PROFILES 
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C  MXBDPKl  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  PROFE.E 
C 

PARAMETER  (MXPRFK1=2,MXBDPK1=4) 

C 

C - CONTROL  INTEGERS  FOR  HYDROGRAPH  OF  1-D  RIVER/STREAM  FLOW 

C 

C  MXPNTKl  :  MAX.  NO.  OF  NODAL  POINTS  FOR  THE  LINE  CROSS  SECTION 
C  MXLINKl  :  MAX.  NO.  OF  LINE  CROSS  SECTION  CAN  BE  SELECTED 
C  MXTTPKl  :  MAX.  NO.  OF  DATA  POINTS  ON  THE  HYDROGRAPH 
C 

PARAMETER  (MXPNTK1=50,MXLINK1=10,MXITPK1=100) 

C 

C - CONTROL  INTEGERS  FOR  1-D  RIVER/STREAM  TRANSPORT 

C 

C  MXMMMKl  :  MAX.  NO.  OF  MATERIAL  PROPERTIES  PER  MATERIAL  FOR  TRANSPORT 
C  MXSRPRKI  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES 

C  MXSRDPKl  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  SOURCE/SINK  PROFILE 
C  MXSJRTKl  :  MAX.  NO.  OF  SOURCE/SINK  PROFILES  OF  TRANSPORT  AT  JUNCTIONS 
C  MXSJDTKl  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  SOURCE/SINK  PROFILE 
C  OF  TRANSPORT  AT  JUNCTIONS. 

C  MXDNPTKl  :  MAX.  NO.  OF  DIRICHLET  BOUNDARY  NODES  OF  TRANSPORT 
C  MXBPPRKl  :  MAX.  NO.  OF  BOUNDARY  CONDITION  PROFILES 

C  MXBPDPKl  :  MAX.  NO.  OF  DATA  POE^S  USED  TO  DESCRIBE  A  BOUNDARY  CONDITION 
PROFILE 

C  MXRCPRKl  :  MAX.  NO.  OF  CHEMICAL  CONCENTRATION  PROFILES  IN  RAINFALL. 

C  MXRCDPKl  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  CHEMICAL 
CONCENTRATION 
C  PROFILES  IN  RAINFALL 

C 

PARAMETER  (MXMMMK1=2) 

PARAMETER  (MXSRPRK1=20,MXSRDPK1=20) 

PARAMETER  (MXSJRTK1=5,MXSJDTK1=200) 

PARAMETER  (MXBPPRK1=20,MXBPDPK1=20) 

PARAMETER  (MXAPPRK1=20,MXAPDPK1=20) 

PARAMETER  (MXRCPRKl  =20,MXRCDPK1  =20) 

PARAMETER  (MXDNPTK1=20) 

C 

C - CONTROL  INTEGERS  FOR  CHEMICAL  AND  SEDIMENT  TRANSPORT 

C 

C  MXNRXK  .  MAX.  NO.  OF  CHEMICAL  REACTIONS 
C  MXNCHK  :  MAX.  NO.  OF  DISSOLVED  CHEMICALS 
C  MXNSIK  :  MAX.  NO.  OF  SEDIMENT  SIZES 

C  MXTNCK  :  MAX.  NO.  OF  DISSOLVED  AND  PARTICULATE  CHEMICALS 
C  MXTNSK  :  MAX.  NO.  OF  SUSPENDED  AND  BED  SEDIMENT  SIZES 

C  MXTSRK  :  MAX.  NO.  OF  DISSOLVED  CHEMICALS,  SUSPENDED  SEDIMENTS,  AND 
PARTICULATE 

C  CHEMICALS  ON  THE  SUSPENDED  SEDIMENT 

C  MXAPPRK  :  MAX.  NO.  OF  PARTIAL  ATMOSPHERIC  PRESSURE  PROFILES 
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MXAPDPK  :  MAX.  NO.  OF  DATA  POINTS  USED  TO  DESCRIBE  A  PARTIAL  ATMOSPHERIC 
PRESSURE 

PARAMETER  (MXNRXK=10,MXNCHK=10,MXNSIK==5) 

PARAMETER  (MXTNCK=MXNCHK*(MXNSIK*2+1),MXTNSK=MXNSIK*2) 

PARAMETER  (MXTSRK=MXNCHK+MXNSIK+MXNCHK*MXNSIK) 

PARAMETER  (MXAPPRK=20,MXAPDPK=20) 

C 

c - CONTROL  INTEGERS  FOR  DESCRIBING  FUNCTIONAL  CURVES 

C 

C  MXXYSK  :  MAX.  NO.  OF  CURES/SERIES 

C  MXXYPK  :  MAX.  NO.  OF  DATA  POINTS  FOR  THE  CURVES 

C 

PARAMETER  (MXXYSK=300,MXXYPK=500) 
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